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このたびは、 「 CcompilerPR 068 Kver 2.0 j を お H い 上げいた だき、 まことに ありが と 
うご ざいました。 

「C compiler PRO -68 K ver 2.0」 （以下、 XC コンパイラと 表記し ます） は、 X 68000 のた 
めに 作られた、 総合 №1 発 ツールです 。本 ソフトウェアを 丨丨 j いて プログラム 丨》1 発を 行う 場合、 
メインメモリが 2 MB 必要です。 

ご 使用に 際して は、 必ず 本 説明 丹に 紀敕 されて いる 报作 方法 •注总 小 項を よ 〈お読みいた 
だき、 正しい 操作に よって 有効に 活用され るよう お願い致します。 



商品 構成は、 下記の 通りです。 

XC システム ディスク 1 1 枚 

XC システム ディスク 2 1 枚 

XC ライブラリ ディスク 1 枚 

C ューザーズ マニュアル 1 册 

C リフ アレンス マニュアル 1 册 

C ライブラリ マニュアル VO し 1 1 册 

C ライブラリ マニュアル VO し 2 1 册 

ソースコード デバッガ マニュアル 1 册 

アセンブラ マニュアル 1 册 

プログラマー ズ マニュアル 1 册 

«鉍 カード 1 枚 



< ご 注 愆> 

1. 本 并 の内衫 について は 万全を 期して 作成 致しました が、 万一 ご不沲 な 点 ゃ娯り 記 * U 
れ など、 お気付きの ことがありましたら、 もよりの シャープ お客様 ご 相談 窓口 あるい 
はお x :( い 求めの 販売店に ご連絡 〈ださい。 

2. 巡 した 結 •の 釤赞 について は、 1 項に かかわらず 饩 任を おいかね ますので ご了承く 
ださい。 

3. 本 卉 の 内容に 関しては、 将米 予告な しに 変 Ui する ことがあります。 

4 •本 杏の 内容の 一部 または 全部を 無断 fe 敉 する ことは、 岱 止されて います。 

5 •付; 成の 登録 カードは 必ず 弊社まで ご 返送く ださい。 

無® 鉍の 方は、一 切の ユーザー サポートが 受けられません ので、 ご注意く ださい。 

6. 本 ソフトウェアを 丨丨 I いて ソフト 開発を 行った 商品を 販売す る 場合の 使用料 （ロイ アリ 
テイ） は 無 依です が、 マニュアル などに 本 ソフトウェアを 使用した ことを 明記く ださ 







「C compiler PRO -68 K ver 2.0」 の 各 マニュアルは 次の 内容と なって います 0 



♦ C ューザーズ マニュアル 

c コンパイラ （ XC > 、 BASIC - C コンバータ （ XBAStoC ) を 使った ソフト 開発に 必要 
な 操作 手順に ついて 説明して います。 

♦ C リフ アレンス マニュアル 

C コンパイラ （ XC ) の 言語 仕様に ついて 説明して います。 

♦ C ライブラリ マニュアル V 0 し 1 

C コンパイラ （ XC ) で 利用で きる？ T / S な C ライブラリの 概要と 使用方法、 標准 ライブ 
ラリ/ BASIC ライブラリ / H 本 語 ライブラリ （小文字 関数） の リファレンスに 関して 
記述して います。 

鲁 C ライブラリ マニュアル V 0 し 2 

IOCS ライブラリ/ DOS ライブラリ （大文字 関数） の リファレンス に関して 記述して 
います。 

•ソースコード デバッガ マニュアル 

c コンパイラ （ XC > の ソース レベルで デ バック 可能な ソースコード デバッガ （ SCD ) 
の 機能に ついて 説明して います。 

•アセンブラ マニュアル 

アセンブラ （ XAssembler ) を 使 丨丨丨 した ソフト 開発に 必要な 操作 手順、 および リンカ 
( XLinker )/ デバッガ （ XDebugger )/ アーカイバ （ XArchiver )/ ライブラリアン 
( XLibrarian )/ コンバータ （ XConverter ) の 取り扱い について 説明して います。 

春 プログラマー ズ マニュアル 

Human 68 k ver 2.0 上の アプリケーション ソフトを 開発す るた めに 便利な 各種 コマンド 
の 操作 方法 、 DOS コール、 IOCS コール、 デバイス ドラ イノぐ、 X - BASIC 外部 関数の 作 
成 方法に ついて 説明して います。 




本書の 構成 

本齊 は、 次の 5 章と 付録から 構成され ています。 



第 1 章 お使いになる 前に 

XC コンパイラを ご 使用いた だく 前に、 本 パッケージに 含まれる ファイルの 構成 や、 内容 
について、一 通りの 説明を 行います。 

また、 XC コンパイラを 使って プログラム 開発を 行う 場合の 流れに ついて 説明し ます。 



第 2 章 コンパイル 

コンパイラの コマンド ラインの 指定 方法に ついて 説明し ます。 

XC コンパイラは スイッチの 指定に より、 プログラム 開発 効率を 上げる ことができます 0 
本 商では、 この スイッチ すべてに ついて 詳しく 説明して あります。 



第 3 章 プログラムの 実行 

コンパイルして 完成した ブロ グラムの 実行に 関して、 引数の わたし かた や、 プログラムが 
どのように 引数を とり 込む かを、 具体的に 説明して あります。 



第 4 章 アセンブラとの インターフェイス 

XC コンパイラは 、 C 言語 プログラムと アセンブラ プログラムを リンクす る ことができ ま 
す 。 

その 際の アセンブラ プログラムの 作成 方法を 説明して います。 

この# •を 読む ことにより、 C をより 深く 理解す る ことができます。 



第 5 章 XBAStoC BASIC プログラム コンバータ 

BASTOC について、 コマンドの 使い かたから、 C 言語に 変換す る 場合の 効率の よい 
BASIC プログラムの 杏き かたまでを 詳しく 説明して います。 

BASTOC を 使う ことにより、 今まで、 BASIC ユーザーだった かた も、 すぐ C ユーザー 
になる ことができます。 







本書の 構成 



第 6 章 追加 BASIC 関数 

MIDI ボードを 制御す るた めに 追加に なった、 BASIC の 命令 や、 拡張され た MML につ 
いて 説明して います。 



付 録 

コントロール 表 や、 キャラクター 表、 また コンパイル スイッチ や エラーメッセージを一 览 
表に して 褐敉 してあります。 
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本章では、 XC コンパイラの インストール 方法に ついて 説明し ます。 
インストールとは、 提供され た XC コンパイラの パッケージを X 68000 の 
OS 、 Human 68 k の ファイルシステムに 組み込む ことを いいます。 

もともと フロッピー ディスクシステムで 提供され ている ため、 Human 68 k 
の ファイルシステム として 勋作 します が、 プログラム 開発を よりよ くす るた 
め、 各 ハードウェァの S 3 境 整備を 中心に 説明し ます。 

また、 プログラム 開発を 行う うえで、 ソース プログラム 作成から コンパイル 
して、 灾 行す るまでの一 連の 流れを 説明して、 プログラム 開発 中に W 低 限 知 
つてい なければ ならない ことにつ いて ふれます。 

本章では、 XC コンパイラ をより 効果的に 使いこなす うえでの 予備 知淼 とし 
て、 何が 必要な のかを 说明 しました。 

なお、 XC コンパイラは X 68000 の 0 S である Human 68 k 上で 動作し ます 
ので、 Human 68 k の コマンドに ついては、 ある 程度の 知 逸が 必要です。 

本饫 では、 0 S や コマンドに ついての 詳しい 説明は 宵 略しました。 

わからない コマンドに ついては、 「 Human 68 k ユーザーズ マニュアル」 を 参 
照して ください。 




第 1 章 お使いになる 前に 



バックアップ ディスクの 作成 一 1 



フロッピーディスクは 於 い 時 問 使って いると、 少しずつで すが 摩擦に よって 
消耗し ます。 

また、 操作 中に コーヒーを フロッピ一 ディスクに こばして しまった などと い 
うこと も、 ない とはいえ ません。 

このような 場合、 it 丨 P : な データ や ファイルが 失われる ことがあります 0 
そこで、 人 yj な フロッピーディスクを このよう なか 一の， K 故 や、 淼っ た枨作 
から 保 通す るた めに、 バックアップを する 必要が あります。 

人 yj な ディスクは、 作 X: の丨 •丨丨 j に 必ず バックアップ をと るが m をつ けて 〈ださ 

い 0 

また、 通常の 作龙 では バックアップ ディスクを 使うよう にします 0 
オリジナル ディスクは、 万一に備えて 人 切に 保莳 して おいてく ださい 0 



QQQ バックアップの 手順 



オリジナル ディスクからの バックアップ 作龙 は、 以 ドに 示す 手順に より 行い 
ます。 

このと き、 ぬ 操作な どで オリジナル ディスクを 破壞 する 位険性 もあります の 
で、 愤丨不: に 行って ください 0 

オリジナル ディスクに ライト プロテクト （フロッピー ディスクの 切り込み 部 
分に 銀紙を 貼る） をして おけば 万全です。 

これ 以降の 説明に おいて、 ドライブ A は フロッピー ディスク ドライブの 
0、 ドライブ B は フロッピー ディスク ドライブの 1 になって いるもの として 
説明 L ます。 

ハードディスク などから 起 制 J した 場合は、 ドライブ 名の A 、 B が ド 妃 の 説 
叫と 異なって いる 場合が あります ので 注 怠して ください。 

新しい フロッピーディスクの 初期化 

バックアップ H 丨の 新しい フロッピーディスクの 初期化を 行います。 

H っ てきた ばかりの 新しい フロッピー ディスクは、 初期化を しないと 使 Jli す 
る ことができません。 





1.1 バックアップ ディスクの 作成 

ここでは、 新しい フロッピー ディスクの 初期化の 方法を 説明し ます。 

① Human 68 k の システム ディスクを ドライブ A に セットし ます。 

② コマンド モードの” A >” プロンプトが 表示され ている 状態から 

A > format /s b : 0) 

と 入力し ます。 

③ 次の ような メッセージが 表示され ます。 

スタ） 欄 化します。 

何 か キーを 押してく ださい 



パ、 ック アップ 用の 新しい フロッピー ディスクを ドライブ B に セットして 
ください。 

ディスクを セットした 後、 上記の メッセージに 従って、 任意の キーを 押し 
ます。 

④ 新しい ディスクが 初期化 （フォーマット） されます。 



初期化 中です 



⑤ 初期化が 終了す ると、 終了の メッセージが 表示 さ 4 












第 1 章 お使いになる 前に 



1.1 バックアップ ディスクの 作成 



⑥ システム ファイルの コピーが 行われます。 



A : の システム ファイルを B : に fc 送し ます 



なお、 システム ファイルの コピーが 不要な 場合は、 ②の コマンド 入力 
で、 / s を 指定す る 必要はありません。 

指定し ない 場合は、 この ⑥の 処理は 行われません。 

⑦ W 後に 次の メッセージが 衣/ j ; •されます。 



他の ディスクを 初期化し ます か？ < Y / N > 



これ 以上 フォーマットを 行わないならば、* N ’ を 押します。 

もし ここで、 絞け て フォーマットを 行う 場合は、 上記の メッセージに T ’ 
と 答えて、 ③ 以下を 繰り返します （なお、 付诚の オリジナル ディスクは 3 
枚あります ので、 初期化す る ディスク も 3 枚 必要です）。 

バックアップの ための コビー 

初期化 された ディスクに、 オリジナル ディスクを すべて コピーし ます。 
以下に コピーの 手順を 示します。 

①” A >” プロンプト 状態を 確認 •して、 次の よう 入力し ます。 



A>diskcopy a : b : [31 



② 次の ような メッセージが 表示され ます。 



5 









クの 作成 



Diskcopy version X.XX 

ドライブ A から ドライブ B へ コピーし ます 

何 か キーを 押してく ださい 






:、 ドライブ B に 先 ほど 初期化 
> 

ジに 従って 任 息の キーを 押し ま 







、ク から パ、 ック アップ ディスクに データが コピーされ ま 



この 後 コピーが 終 



ージが 表示され ます。 



mmmmM 



コピーを 終ア しました 

他の ディスクを コピーし ます か？ < Y / N > 



オリジナル ディスクは 3 枚あります ので、 1 枚 H の ディスクの コピーが 右 
了した 場合は T ’ と 押して、 ② 以下の 作業を 行います。 

3 枚 目の コピー 終了には , N ’ を 押してく ださい。 

これで バックアップは 完了し ます。 



ドライブ A から オリジナル ディスクを イジ ェクト して、 大切 I 
いてく ださい。 



6 









第 1 章 お使いになる 前に 



スクの 内容 



には、 次の ような ファイルが 含 
ファイルが すべて 揃ってい る 力 



XC システム デ 




XC システム ディスク No . l の ルート ディレクトリには、 次の ような フ アイ 
ル、 および サブ ディレクトリが あります 0 



ルート デイ レクト 




HUMAN . SYS 
CONFIG . SYS 
KEY . SYS 
USKCG . SYS 
BEEP . SYS 
STARTUP . ENV 
AUTOEXEC . BAT 
COMMAND . X 

SYS (ディレクトリ） 
BIN (ディレクトリ） 
ASK (ディレクトリ） 
HIS (ディレクトリ） 
ETC (デイ レクト リ） 



XC システム ディスク No . l には、 Human 68 k を起勋 する のに 必要な フ ァイ 
ルが 格納され ており、 この ディスク 墘 体で Human 68 k を 起# 力す る ことが で 
きます。 

なお、 XC コンパイラ 本体 （ CC . X ) や ライブラリ、 インクルード ファイル 
などは、 XC システム ディスク No .2 に 格納され ています。 

絞いて、 各 サブ ディレクトリに 格納され ている ファイルの 説明を します 0 






PRNDRV . SYS 
PCMDRV . SYS 
ASK 68 K . SYS 
KAMDISK . SYS 
SRAMDISK . SYS 
PRNDRV 1. SYS 
PRNDRV 2. SYS 
PRNDRV 3. SYS 
SCSIDRV . SYS 
0 PMDRV 2. X 
FL 0 AT 1 . X 
FLOAT 2. X 
HISTORY . X 
IOCS . X 



プリンタ ドライバ （シャープ * CZ 系） 

PCM ドラィバ 

II 本 語 処理 フロント プロセッサ 

RAM ディスク ドライバ 

SRAM デイスク ドライバ 

プリンタ ドライバ （エプソン • ESC / P 系） 

プリンタ ドライバ （NEC • PC - PR 201 系） 

プリンタ ドラ イノぐ （NEC • NM -9300 系） 

SCSI ドラィバ 

FM B ■•源 ドラィバ （ MIDI 対応〉 

汴勋 小数点 演览 エミュレータ （シャープ U •様) 
浮 勋 小数点 演兗 エミュレータ （IEEE U •様） 

ヒス 卜リ ドライバ 
IOCS ドライバ、 



CONFIG . SYS の 中 1 



DEVICE = PRNDRV . 
DEVICE = FLOAT 2. 



のように 指定す る ことで、 システムに 組み込む ことができます 0 

なぉ、 ファイルの 拡張 子が . X である デバイス ドライバは、 コマンド ライン 

から 実行す る ことで、 システムに 追加す る こと もで きます。 









AS . X 
LK . X 
DB . X 
SCO . X 
SCD . CNF 
SCD . HLP 



AR . X 
LIB . X 




BIND . X 
CASE . X 



DRIVE . X 
MOVE . X 
PROCESS . X 
COPYAL し X 
TERM . X 
TOUCH . X 
TREE . X 
WHERE . X 
FORMAT . X 
DISKCOPY . X 
MAKE . X 
PRINT . X 
ED . X 
ED . HLP 



アセンブラ 
リンカ 
デバ ッカ 

ソースコード デバ ッカ 

ソースコード デバ ッカ 用 コン フィ グフ ァイ ル 

ソースコード デバ ツカ 川 ヘルプ ファイル 

アーカイバ 

ライブラリアン 

コンバータ 

バインド ツール 

ファイル 名、 ディレクトリ 名の 大 / 小文字 変換 ツ 

一 ノレ 

ドラィブ 悄 報の 表示、 ドラィブ 名の 変 ai ッール 

ファイル 移觔 ツール 

プロセス 表示 ツール 

ファイル fe 送 ツール 

簡鉍 ターミナル ツール 

タイムスタンプ 変 史 ツール 

ディレクトリ 構造の 表示 ツール 

ファイル 検索 ツール 

フォーマッタ 

ディスク コピー 

プログラム 保守 ユーティリティ 

バックグラウンド 印刷 ツール 

エディタ 

エディタ 用 ヘルプ ファイル 







クの 内容 





(3) ASK 

この ディレクトリには、 丨丨本 語 処理 フロント プロセッサ ASK 68 K の S 3 境設 
定 ファイルが 格納され ています。 



ファイル 名 


内 容 


ENV 1. ASK 
ENV 2. ASK 
ENV 3. ASK 
ENV 4. ASK 
ENV 5. ASK 


H 本 語処坪 環境 設定 ファイル No.l 
II 本語処 坪® 境 設定 ファイル Na 2 
11 本 語 処理 環境 設定 ファイル No .3 
II 本 語 処理 51 境 設定 ファイル No .4 
H 本,! S 処押 .51 境 設定 ファイル No .5 



⑷ HIS 

この ディレクトリには、 ヒストリ 機能、 および キーボード コントロールを 灾 
祝す る ヒストリ ドライバが 使 川す る ファイルが 格納され ています 0 







KEY . HIS 
HISTORY . HIS 
HISTORY . MLP 


mmmm 



ヒストリ 機能、 および キーボード コントロール に関しては、 「 Human 68 k 
ver 2.0 ユーザーズ マニュアル」 を 参照して ください。 

(5) ETC 

この ディレクトリには、 XC コンパイラを インストール するとき に 使 川す る 
バッチ ファイル、 および コマンドが 格納され ています。 

ユーザーが 丨 A : 接 使⑴す るのは INSTAL し BAT だけで、 他の ファイルは 
INSTALL . BAT で 使 川され る ファイルです。 



10 








章 お使いになる 前に 




1 NSTAL し BAT 
FD . BAT 
FDR . BAT 
I ID . BAT 
YN 



TOOL . X 



インストール •メイン プログラム 
インスト一 ル •サブ プログラム （FD JIU 
インスト一 ル •サブ プロ グラ J 
インストール •サブ プロ グラ J 

INSTALL BAT で使⑴ され 



INSTALL . BAT から 呼び出 




XC システム ディスク No .2 



、イス ク N0 . 2 の ルート ディレクトリには、 次の ような サブ デ 
^ 納 されて います。 



ク卜 



CC 

INCLUDE 

LIB 

BASIC 2 

BC 

SAMPLE 



イス ク No .2 には、 XC コンパイラ 本体 （ CC . X ) や ライブ ラ 
ン クルー ド ファイル、 BASIC 閲迚の ファイルが 格納され て 



スク 中. 沐 では Human 68 k を 起! fJj する ことは できません。 
レクト リに 格納され ている ファイルの 说 叫を します 0 



リ には、 XC コンパイラの 本体で ある （ X . X だけが 格納され 
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1.2 ディスクの 内容 



(2) INCLUDE 

この ディレクトリには、 XC コンパイラで 使) II する すべての ヘッダ ファイル 
が 格納され ています。 

なお、 ERROR . H は ANSI 说 格では ERRNO . H として 定義され ています。 
必要の ある 方は RENAME してく ださい。 



ファイル 名 


内 容 

l - - ■ - - — _ _ 一 1 1 ■ — 


ASSERT . H 


# 太: 行 時 チェック マクロの 定莪 


AUDIO , n 


ADPCM 問 数の 定莪 


BASIC , n 


BASIC 斜 1 み 込み 丨对 数の 定義 


BASICO . H 


㈣ 丨 f 丨丨処 坪 関係な どの 関数の 定戒 


CLASS . II 


データ 5? の定旄 


CONIO . II 


コンソール 入出力 丨对 数の 定義 


CTYPE . H 


文字 チェック および 文字 変換の マクロ 定義 




ディレクトリ 操作 開 数の 定義 


DOSLIB . H 


Human 68 k の ファンクション コールの 関数の 定義 


ERROR . H 


エラー コードの シンボル 定義 


FCNT し H 


低 水咿 入出力 閲 数の 定数を 定義 


FCTYPE . M 


CTYPE . H で定 在され ている マクロの 閲 数 版の 定義 


FLOAT . H 


兑 術 ライブラリの 定数の 定義 


GRAPH . H 


グラフィック 間数の 定義 


IMAGE . H 


イメージ 関数の 定義 


10. H 


ファイル 枨 作と 低 水: や •人出 力 関数の 定義 


IOCSLIB . H 


X 68000 の 10 CS コールの 閲 数の 定義 


JFCTYPE . H 


漢字 対応 ライブラリ 間数の 定義 


JSTRING . II 


漢字 対応 ライブラリ 関数の 定義 


LIMITS . H 


各 データ 型の W 効範丨 相 の 定義 


MATH . H 


苡術 ライブラリ 問 数の 定義 


MOUSE . H 


マウス 関数の 定義 


MUSIC . H 


FM 音源 関数の 定箱 


MUSIC 2. H 


FM 皆淞 （ MIDI 対丨 芯） 関数の 定義 


PROCESS . H 


プロセス制御 関数の 定義 


SETJMP . H 


SETJMP 関数 等の 定義 


SIGNAL . H 


SIGNAL 関数 等の 定義 






1 章 お使いになる 前に 



クの 内容 



STRING . II 
TIME . H 
TIMEB . H 
UTIME . H 
DOSCALL . MAC 



ERROR . MAC 



aHcIii 



FDEF . H 
FEFUNC . II 



IOCSCAL し MAC 
LIMITS . MAC 
MALLOC . MAC 



PROCESS . MAC 
STAT . MAC 
STDIO . MAC 
TIME . MAC 



スプラ イト 関数の 定義 
STAT ぉょび FSTAT 関数 等の 定義 
不定 5? 引数の 取り出し ⑴ マクロの 定義 
標咿 定数、 標咿 関数 Ml シンボルの 定衣 
標妒 入出力 問 数の 定義 
標準 ライブラリ 閲 数の 定義 
ジョイスティック 関数の 定衣 
文字列 操作 用 関数の 定義 
TIME 関数 等の 定義 
FTIMEIW 数婷の 定義 
UTIME 関数 等の 定莪 

Human 68 k の フアン クシ ヨン コールのへ ッ ダフ 
ァイ ル 

エラー コードの ヘッダ ファイル 

低水咿 入出力の ヘッダ ファイル 

BASIC 外部 関数 丨丨丨 の 定数の 定義 

浮動小数点 演箄 エミュレータ 呼び出し 用 シンボル 

の 定義 

X 68000 の IOCS コールの ヘッダ ファイル 
ft データ 型の 数侦範 N の ヘッダ ファイル 
メモリ 管理の ヘッダ ファイル 
兑 術演览 の ヘッダ ファイル 
プロセス制御の ヘッダ ファイル 
STAT および FSTAT の ヘッダ ファイル 
低水準 入出力の ヘッダ ファイル 
TIME の ヘッダ ファイル 





スタの 内容 



ラで 使 ) I 丨 する すべての ライブラリ ファ 



7 ン （ LIB. X ) で 複数の オブジェ ク 

ファイルです 0 



CLIB. L 
BASLIB. L 
DOSLIB. L 
IOCSLIB. L 
FLOATFNC. 
FLOATEML. 



C ライブラリ 

BASTOC ラ 



DOS 

IOCS 



ル ラ 



汗 觔小数 点 ド 
浮動小数点 ェ 



BASIC2 



の デイ レ ク 
れ ています 



ク トリには、 X-BASIC ver 2.0 の 本体、 および 外部 関数が 格納 



BASIC. X 
BASIC. CNF 
MUSIC2. FNC 
AUDIO. FNC 
GRAPH. FNC 
MOUSE. FNC 
STICK. FNC 
IMAGE. FNC 



BASIC インタープリタ 
BASIC コン フイ グ ファイル 
FMff 源 （ MIDI 対応） 外部 関数 
ADPCM 外部 閲数 

グラフィック 外部 聞 数 
マウス 外部 関数 
ジョイスティック 外部 関数 
イメージ 外部 関数 
スプラ イト 外部 閲数 





章 お使いになる 前に 




丨 ） BC 

: の ディレクトリには 、 BASTOC ( X - BASIC から XC への プログラム 変 
の 時に 使丨 II される プログラム および 外部 関数の 定義 ファイルが 格納され 
: います。 



ファイル 名 


内 容 


BC . X 


BASTOC 


AUDIO . DEF 


ADPCM ⑴ DEF フ アイ ル 


MOUSE . DEF 


マウス 丨 |j DEF フ アイ ル 


SPRITE . DEF 


スプラ イト 川 DEF ファイル 


STICK . DEF 


ジョイスティック 川 DEF ファイル 


IMAGE . DEF 


イメージ 川 I ) EF ファイル 


GRAPH. DEF 


グラフィック 川 DEF ファイル 


BASIC . DEF 


BASIC 組み込み 関数 丨1 丨 DEF ファイル 


MUSIC 2. DEF 


FM S •源 （ MIDI 対応 > IH DEF ファィル 


BASIC . CNF 


BASTOC コン フイ グフ アイノ レ 



；) SAMPLE 

ニの ディレクトリには、 いくつかの サンプル プログラムが 格納され てい ま 

r 〇 

尸 ン プル プログラムの コンパイルん •法 やその 機能に ついては、 SAMPLE . 
)0 C という ドキュメント ファイルを 参照して ください 0 



m 3 xc ライブラリ ディスク 



こ ライブラリ ディスクには、 XC システム ディスク N 0.2 にある ライブ ラ 
の ソース プログラムが 穴 まれて います。 







クの 内容 



CLIB . ARC や BASLIB . ARC のよう な アーカイブ ファイルから ファイルを 

とり 出す 方法と、 内容を 確認す る 方法を 説明し ます。 



(1) ソースファイルを とり 出す 方法 

茜 式 




CLIB . ARC から COS . S という ソースファイルを とり 出します。 



(2) 内容を 確 K する 方法 

書式 
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第 1 章 お使いになる 前に 



ファイル 構成 



XC コンパイラは、 おもに コンパイラ 本体、 インクルード ファイル、 ライフ 
ラリ ファイルの 3 M 頌の ファイルから 構成され ています 0 
本節では、 これら 3 つの ファイルを 中心に 説明し ます。 



UH 実行可能 ファイル 



Human 68 k の 実行可能 ファイルは . X という 拡張 子を もっています 0 
以下には 、代表的な 実行可能 ファイルを 説明し ます。 

(1) CC. X 

CC . X は、 コンパイラを 制御す る 部分と C コンパイラ 本体が ひとつに なっ 
た プログラム ファイルです 0 

BASIC から C に 変換したり、 C の ソースファイルを コンパイルして、 アセ 
ン ブラ ソースファイル や オブジェクト ファイルを 作成す る C コンパイラ 本 
沐と 、必要に応じて LK . X を 呼び出す、 つまり コンパイラ 中の 各 フェーズ 
を つかさどる プログラムからで きています。 

CC . X は、 LK . X を 呼び出す ことにより、 実行可能 ファイルを 作成し ます 0 
つまり、 コンパイラを 実行す るには、 この CC.X を 呼び出せば よい わけで、 
Human 68 k の コマンド モードから’’ CC ” と、 それに 絞 〈スイッチ 指定 や、 フ 
ァイ ル 名 指定と ともに 入力す る ことにより、 CC . X を 呼び出します 0 

(2) AS. X 

AS . X は アセンブラです。 

この 実行 ファイルは、 上記の CC . X で アセンブラ ソースファイルを 出力し 
た 場合に、 その あとから、 オブジェクトを 作成 するとき に 使用し ます。 

C 言語 プログラムの 開発に 商 接 関係し ません が、 コンパイラを 深く 知る こと 
により、 アセンブリ 言語と 組み合わせて、 關 発を 行う こと も 可能に なり ま 
す。 

なお、 アセンブラの 詳しい 説明は、 「アセンブラ マニュアル 」 を 参照して く 
ださい。 
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1.3 ファイル 構成 



(3) LK. X 

LK . X は、 上妃の AS . X で アセンブルされ た オブジェクト コードを、 他の 
オブジェクト コードと ともに 結びつけて、 || 的と する 実行可能 ファイルを 作 
成す る プログラムです。 

一般的に この LK . X を リンカと 呼んで います 0 

(4) AR. X 

AR . X は、 テキスト ファイル 议邱 プログラムで、 アーカイバと 呼びます 0 
AR . X では、 テキスト ファイルの 作成、 変疋 、削除と いった テキスト ファ 
イル に関する 管理を 行います。 

(5) LIB. X 

IJB . X は、 オブジェクト 议现 プログラムで、 ライブラリアンと 呼びます。 
LIB . X では、 オブジェクト ファイルの 作成、 変 史、 削除と いった オブジェ 
ク トフ アイ ルに 明す る符 坪を 行います 0 

(6) BC. X 

BC . X は、 BASIC から C 宫 雄に 変換す る トランスレータです。 

洋 しい 説明は、 「第 5 京 XBAStoC BASIC プログラム コンバータ j で 行 
います。 



インクルード ファイル 



インクルード ファイルは、 C 言語の# include という 命令を 使って、 プリ プ 
ロ セ ッサが、 とり 込む ことができる テキストファイルです。 

この インクルード ファイルは、 • H という 拡張 子を もった ファイルで 構成 さ 
れ ており、 ユーザー プログラム 中の 先頒 に # include く インクルード ファ 
イル 名〉 と 宣言して おけば、 コンパイラの プリプロセッサ により、 インク 
ルード ファイル 名に あたる 部分を ユーザー プログラムに 展開して くれます。 
標带で 提供され る インクルード ファイルは、 「1.2 ディスクの 内容」 で 示し 
たような ファイル により 稱成 されて いますが、 XC コンパイラの 利用者 も、 
独 f 丨の インクルード ファイルを 作成して 贷鉍 できます。 

このような 機能は、 C 言語の 特長の 1 つで も あり、 プログラムの 簡素化と 効 
率の よい プログラム 展開を する うえで®: 要な 機能です。 
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第 1 章 お使いになる 前に 



1.3 ファイル 構成 

non ラィブラリ ファィル 



ラィブラリ ファイルは . L という 拡张 f •を もった ファイルで _成 されて いま 
す。 

ライブラリ も インクルード ファイルと 丨 丨丨丨 様に 、 C 丨 US の 人き な 持 U の 1 つに 
なって います。 

もともと、 CrUS では 人出 カ閲 係な どを サポートして おらず、 マシンに 依# 
する 部分は、 すべて ライブラリ という 才 ブジェク 卜 ファイルの It •まりに よっ 
て 提供され ます。 

「1.3.1 次: 能 ファイル j で 紹介した リンカ < LK . X > によって、 ユー 
ザ 一 プログラムが 必要と する ライブラリ 屮の丨 が、 この ライブ ラ リファイ 
ルから 抜き とられて、 リンク されます 0 

xc コンパイラ による プログラム 叫 允を けうう えで、 利丨丨 I 打 n 分の ラィブ ラ 
リファィ ルを fl : 成して， 7?坪 する ことにより、 丨》丨 允の 効屮 が丨 •.がります。 

(1) C し IB . し 

C , 丨 ••丨 , v 、 v •川の ラィブラリです。 

この ライブラリの ソースファイルは、 XC ライブラリ ディスクに CLIB . 
ARC という 名 前 で 入って います。 

(2) BAS し IB •し 

X - BASIC リ/ •川の ライブラリです。 

この ライブラリの ゾー スフ ァイ ル も、 XC ライブラリ ディスクに BASLIB . 
AKC という Ziiij で 人って います。 

(3) DOS し IB . し 

Human 68 k の ファンクション コールを 呼び出す ための ライブラリです。 

(4) IOCS し IB . し 

X 68000 の IOCS コールを 呼び出す ための ライブラリです A 
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1.3 ファイル 構成 



(5) F し OATFNC •し 

小数点 演 57 •ドライバを 呼び出す ライブラリです。 

これを 使 川す ると、 次: 行 ファイルが コンパクト になり、 コプロセッサ ボード 
を利⑴ する こと もで きます。 

作成した 次: 行 ファイルを 孙 作させる ためには、 FL 0 AT 2. X または 
FL 0 AT 3. X が 必要です。 

(6) F し OATEM し •し 

俘 勋 小数点 演笕を 行う ライブラリです。 

これを 使 III すると、 FL 0 AT 2. X を 必要と しない •火: 行 ファイルが 作成で きま 






第 1 章 お使いになる 前に 



インストールと 開発 環境の 設定 丨 



本飫 では、 XC コンパイラの インストール 方法を 説明し ます。 

インストールを 行わない と、 XC コンパイラを 使用す る ことは できません。 
XC コンパイラの インストールには、 INSTAL し BAT を 利用す る オート • 
インストールと、 ユーザーが コマンド シェル 上から COP Y コマンド や 
MKDIR コマンド などを 利用して 、オリジナルの システム ディスクより ファ 
イ ルを コピーす る マニュアル •インストールの 2 神. 類が あります。 
ほとんどの 場合、 オート •インストールで インストール できる ので、 W 初に 
オート •インストールを 试 してみ てくだ さい。 

以下では 、オー 卜 •インストールと マニュアル •インストールを 分けて 説明 
します。 



才 一 卜 •インス 卜 一 ル 



本 項では、 INSTAL し BAT を 用いた オー 卜 •インストール について 説明し 
ます。 

また、 この場合 インストール する デバイスに よりその 方法が 逮 うので、 フロ 
ッ ピー ディスクと ハードディスクに 分けて 解説し ます。 

フロッピー ディスクの 場合 

XC コンパイラ ver 2.0 は、 その 機能が 大幅に 拡張され たので システム ディ 
スク 1 枚では 収まり きらず、 X - BASIC や XC を 使うた めに、 ディスク 2 枚 
分の ユーティリティが 必要と なります。 

そのため 、オリジナルの ディスク 構成では、 システム ディスク だけで フロ ッ 
ピー ディスク ドライブ 2 台を 占有して しまい、 ユーザーの 作業用 ディスクが 
使用で きません。 

そこで、 作業用 ディスクを 使用で きる よう、 システムの?^ 構成を 行う のが イ 
ン ストール プログラムの 役割です。 

この インストール プログラム により、 XC コンパイラは 次の 3 枚の ディスク 
に まとめられます。 
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1.4 インストールと 開発 環境の 設定 



(1) Human 68 k 起 i カディス ク 

Human 68 k を 起 抑し、 デバイス ドライバを 組み込み、 コマンド シェルを 立 
ち丨 •.げ るた めの ディスクです。 

この ディスクは、 システム 起 jijj 後に ランタイム ディスクと 交換し ます。 

この ディスクには エディタ や ソースコード デバッガ などの ツールが 納められ 
ています。 

これらを お使いになる 場合は ランタイム ディスクと 交換し ます。 

(2> ランタイム ディスク 

XC コンパイラの 本体 や、 X - BASIC や リンカな どの ユーティリティが 格納 
された ディスクです。 

システム 起勋 後に Human 68 k 起 仙 ディスクと 交換し、 以後 システム デ イス 
ク として 使 JII します。 

通黹 、この ディスクは A ドライブと なります 0 



(3> 作業用 ディスク 

ユーザーが 例 人で 作成した プログラムの ソースファイル や オブジェクト ファ 

イル などを 格納す る ディスクです 0 

迚??;、 この ディスクは B ドライブになります。 

つぎに、 インストール プログラム INSTAL し BAT を 使 川した システムの 
インストール" 法に ついて 説明 します。 

① まず、 インストールの 除に 使丨 H する ディスクを 2 枚 作成し ます。 

この ディスク 2 枚は、 FORMAT コマンドで フォーマットした 空き ディ 
ス クを丨 IbS します 0 

フ ォー マットの "法は、 「1. 1 バックアップ ディスクの 作成」 を 参照し 
てくだ さい。 

② X 68000 の 屯 源を ON にして、 バックアップした XC システム ディスク 

No . l を ドライブ 0 に セットして 〈ださい。 • 

③ Human 68 k の 起! f 力 メッセージの 後に、 「 C コンパイラの 紺み 込みを 始め 
ます か [ Y / N ] j という メッセージが 衣 示されたら、* Y ’ を キーボードよ 
り 人力し ます。 

インストールす るつ もりがない ときは、 ここで’ N ’ を 人力す ると、 コマン 
ドシェ ルに 纪り ます。 
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④ インストール プログラムが 泣み 込まれ、 次の ような メニュー 丨由 •丨丨 fii が 表示 さ 
れ ます。 



INSTfLL for CcoapileriQlQS ^er2.00 Copyright 1990 SHW 




S 觀バ臟 し 毹齡 



ここでは、 xc コンパイラを 紺み 込む デバイスを 選択し ます。 

[ D 、 [ I キーで W 色の カーソルを 「フロッピー ディスク j に 合わせて、 リタ 一 
ン キーを 押して 〈ださい。 

⑤ フ オー マッ 卜济 みの フロッピー ディスク 2 枚の 丨丨 丨总 がで きている かどう か 
を 間いて 〈るので、* Y ’ を 入力して ください。 

もし、 ①で⑴ 愆 していなければ、 を 入力 すれば コマンド シェルに 戻り 
ます。 

⑥ 次に、 コピー 元の ドライブ 名を 問いて くるので、 视在 システム ディスクが 
セットされ ている ドライブ （通常は A ドライブ） を 選択して ください。 

⑦ 次に、 コピー 光の ドライブ 名を 叫いて くるので、 呪 在 空いて いる ドライブ 

( B ドライブ） を 選択して ください。 

⑧ ここで、 次のように RAM ディスク や BASIC などを 使 川す るか どうかを 
間いて きます。 
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IMSTfll for Ca**»ileriaXS5 ^er2.00 Copyright 1990 SHPfiP 




■•さみ） ■(前に 戻る) 




必要に応じて？ vmn を m [ I ] キーと リターン キーで 設定し、 終わったら 
「確定 j に カーソルを 合わせ、 リターン キーを 押します。 

なお、 「使 丨丨丨 しない j と 設定した ぶ mi は、 ランタイム ディスクから vt かれ 
るた め、 その 分 ランタイム ディスクの •今: き界 锨 が增 加し、 インストール 終 
了 後に 別の コマンド や ユーティリティを コピーす る ことができます。 

⑨ Hunian 68 k 起！ fJj ディスクを 作成す るた め、 XC システム ディスク No.l 
からの コピーを 行う ので、 フォーマット 济 みの 空き ディスクを 指定され た 
ドライブに セットし、 を 入力して ください。 

すると コピーが 開始され ます。 

※コピー 中は、 キーを 押さないで ください。 

⑩ Human 68 k 起勋 ディスクを 作成し 終わる と、 次は ランタイム ディスクの 
作成です。 

XC システム ディスク No .2 と フォーマット 済みの 空き ディスクを、 指定 
された ドライブに セットして ください。 

その後、 を 入力す ると コピーが 始まります。 

⑪ XC システム ディスク No .2 から ランタイム ディスクへの コピーが 終了す 
ると、 次は、 XC システム ディスク No . l から ランタイム ディスクへの コ 
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ピーを 行います。 

XC システム ディスク No . l を 指定され た ドライブに セットし てから、 f Y ’ 
キーを 入力して ください。 

コピーが 開始され ます。 

⑫ コピーが 終了す ると、 リターン キーの 入力 待ちになります。 

ここで リターン キーを 入力す ると、 フロッピー ディスクへの インストール 
は 終了になります。 

⑬ Ai 後に、 今 作成した 起觔 ディスクを ドライブ 0 に 入れる ことを 促す メッセ 
一 ジが丨 W 丨而に 表示され ます。 

ここで、 ’ Y ’ を 入力す ると リセット されて Human 68 k が 起動され ます。 

• N ’ を 入力す ると コマンド シェルに 戻ります 0 

このよう にして 作成した ディスクで システムを 起觔 する には、 次の 手順が 必 
要です。 

① X 68000 の 屯 源を ON にし、 ドライブ 0 に Human 68 k 起觔 ディスクを セ 
ット します。 

② Human 68 k が起觔 すると、 ランタイム ディスクと 差し 锊 える ことを 促す 
メッセージが _而 に 表示され ます。 

そこで、 ドライブ 0 に セットされ ている Human 68 k 起動 ディスクと ラン 
タイム ディスクを 差し 抒え 、ドライブ 1 に 作業用 ディスクを セットし ま 
す。 



これで、 XC コンパイラが フロッピー ディスク ベースで 使用可能 になり ま 
す。 



ハードディスクの 場合 

XC コンパイラ ver 2.0 を、 インストール プログラムを 用いて ハード デ ィス 
クに インストールす るのは、 フロッピー ディスクに インストールす るのに 比 
ベる とそれ ほど 難しくありません。 

ただ、 ハードディスクには 敁 低で も 2 M バイトの 空き 容设が 必要で ある こと 
に 注意して ください。 

インストール プログラム INSTAL し BAT を 使用した システムの インスト 
一 ル 方法に ついて 説明し ます 0 
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① ハードディスクが 内藏 でな 〈增設 されて いる 場合は、 まず ハードディスク 
の 屯 源を ON にします。 

つぎに バックアップした XC システム ディスク No.l を ドライブ 0 にセッ 
卜し、 IOPT.1I キーを 押しな がし X68000 の 屯 源を ON にして 〈ださい。 
これにより、 ドライブ 0 に セッ 卜されて いる フロッピーディスクより 強制 

的に Human68k が 起 $ 力 します。 

なお、 fOPT.ll キーは Human68k の起觔 メッセージが 表示され るまで 押 
し 絞け てくだ さい。 

② Human68k の 起# 力 メッセージの 後に、 r C コンパイラの 組み込みを 始め 
ます か [Y/N ]」 という メッセージが 表示され たら、. Y’ を キーボードよ 
り 入力し ます。 

インストールす るつ もりがない ときは、 ここで ， N ， を 入力す ると、 コマン 
ドシェ ルに 戻ります。 

③ インストール プログラムが 読み込まれます。 
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ここでは、 XC コンパイラを 組み込む デバイスを 選択し ます。 

[H [ D キーで 黄色の カーソルを、 上の 阃面 のように 「ハードディスク」 に 
合わせて、 リターン キーを 押してく ださい。 
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④ コピー 先の ハードディスクの ドライブ 名を 間いて 〈るので、 XC コンパイ 
ラを インストール する ハードディスクの ドライブ 名を 選択して ください 0 

⑤ 選択され た ハードディスクの 空き 容 W : が 2 M バイト 以丨 •.あるか どうか チェ 
ック します。 

もし、 空き 容 «： が 足りなければ 、インストールで きないので、 コマンド シ 
エルに 戻ります 0 

⑥ XC コンパイラ 本体 （CC X ) や ライブラリ、 ヘッダ ファイル などを 格納 
する ディレクトリを 設定し ます。 

注 尨すべき ことは、 ここで 指定で きる ディレクトリは 、ルート デイ レクト 
リの 1 つ 下の サブ ディレクトリ だけ、 という ことです。 

つまり 



C ： ¥XC ver 2 



は 許され ますが、 



C ： ¥ XC ¥ ver 200 
C ： ¥ BIN¥XC 



といった 指定は できません。 

もし、 このような サブ ディレクトリに 格納したい 場合は、 マニュアルで イ 
ン ストール する 必要が あります。 

なぉ、 このと きすで に# 在す る ディレクトリを 指定した 場合は、 上 许 きす 
るか どうか 間いて くるので 、上?! : きして いいなら* Y ’ を、 そうでなければ 
* N ’ を 入力して ください。 

⑦ ディレクトリの 指定が 終了す ると、 次のように 作成され る サブ ディ レクト 
リが 表示され 、コピーの 準備が できて いるか どうか 叫いて きます。 
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I 叫 曲 の 衍 






界を 表/ •しこ 



に XC システム ディスク No . l 、 No .2 を 各 ド 
0 

クを セットし 終わったら、* Y ’ を 押してく だ S 
れ ます。 

，を 押す と、 インストールは 中断され コマン 



ると、 C の 琛 境 設定を 行う バッチ ファイル | 




BAT の 内 










お使いになる 前に 



INSTftl for C ， 



uer2.00 Copyright 1990 SHW> 



•一 ディスク 




XC デ < レクト リ 
3 ンパ イラ 
インクルード 771 
2 イブ ラリ 卩乃 
Basic 77T ィし氕 
b as to cm レ 欠 

ilft ツール 77T ル 欠 




C：«C 

C：»XCWX 

C ： WCfiraiD 6 

C:«OLlB 

C ： IXCWSIC2 

C ： WC»K 

C ： WC«BIN 



打％^^?? my ぬ c 妒 

palh^:WC;A:WC«lN;A:fXC«X; 
s«t inc!ude^ ： WC» 

«t hb^:«(C»lIB ； 



• »T > を ドラ 



麟職の 激湯織 



tY/N] 



C . BAT の 内 落を 変 01 する 必要の ない ときは、 ’ Y ’ を 入力して ください。 

C . BAT の 内 答を 変 史 したい 場合は、 f N ’ を 押してく ださい。 

なお、 ここで 変 史 できる のは、 C . BAT で 設定され る コマンド 検索 パス や 
ライブラリ パス、 インクルード パスの ドライブ 名 だけです。 

C . BAT は、 指定した ハードディスクの ルー 卜 ディレクトリに コピーされ 
ます。 

そのため、 必ず コマンド 検索 パスに その ハードディスクの ルート デイ レク 
トリを 指定して おいてく ださい。 

指定し な垛 合、 C . BAT を 突 •行で きない ことがあります。 

⑨ C BAT の コピーが 終了す ると、 リターン キーの 入力 侍ち になります。 
ここで リターン キーを 入力す ると、 ハードディスクへの インストールは 終 
了になります 0 

ここで T ’ を 入力す ると リセットされ、* N ’ を 入力す ると コマンド シヱ ルに 
戻ります。 

こうして インストールした XC コンパイラを 使用す るには、 ハードディスク 
より Human 68 k を 起 i 力し、 コマンド シェルが 立ち上がった ところで、 
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A>C® 



としてく ださい。 

すると、 C . BAT が 次: 行され、 コマンド 検索 パス や インクルード パス、 ライ 
ブラ リバスが 設定され ます 0 



マニュアル •インストール 



ほとんどの 垛合 、オート •インストールで 問に 合う のです が、 次の 垛合 オー 
卜 •インストールを 利 IIJ する ことは できません。 

(1) ハードディスクの 空き 容量が 2 M バイトに 足りない 場合 
<2> ハードディスクに インストール する 場合、 XC コンパイラ 本体 （ CC . X ) 
を 格納す る サブ ディレクトリを、 ルート ディレクトリの 2 つ 以上 深い サ 
ブ ディレクトリに 作成したい 場合 

この 坳介 は、 ューザーが COPY コマンド や MKDIR コマンド などを コマン 
ドシェ ル丨 ••で 欠 行して、 必要な ファイルを ハードディスクに コピーし なけれ 
ばな りません。 

これを マニュアル •インストールと いいます。 

マニュアル •インストールの ときに 注总 すべき 点を 以下に 示します。 

① Human 68 k や コマンド シェルな どの システム ファイルの バージョンを 2 . 
0 以 h にす る。 

② Human 68 k 起觔 時に 浮勋 小数点 ェミュレータ FL 0 AT 2. X を 組み込む よ 
う、 CONFIG . SYS を 設定す る。 

③ コマンド 検索 パス や CC の パス、 ライブラリ パス、 インクルード パス、 

BC の ハ 0 スを AUTOEXEC . BAT の 中で 設定す る。 

コマンド 検索 パスは PATH コマンドで、 CC の パスは 環境 変数 cc 、 ライ 
ブ ラリ パスは 琛 境 変数 lib 、 インクルード パスは 環 境 変数 include 、 BC の 
パスは 環 境变数 be により 設定で きます。 
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プログラム 開発の 流れ 



XC コンパイラは、 ソースコードから オブジェクト コードを 生成す る 一 神の 
卜 ランス レー タで すが、 プログラム 間 発を 行 うう えで、 コンパイラを とりま 
〈環境 も 理解し なければ なりません。 

前 節では、 コンパイラが 觔 作す るた めの 環境を 中心に 説明し ましたが、 本節 
では、 プログラム 丨》] 発の ー迚の 流れを 中心に、 プログラム 開 発に 必要な ユー 
ティリ ティな どに ついて 说 叫し ます 0 



ソ -スプ □グラムの 作成から 実行まで 



ソフトウェアの 間 発では、 使⑴ する パ 措に よって さまざまな 間 発 方法が あり 
ますが、 人き く 分ける と、 ⑴ ソース プログラムを 作成し、 ⑵ コンパイルし 
て、 （3) デバッグ する、 という 3 つの フェーズに 分ける ことができます 0 
もっとも、 BASIC のよう な インタープリタ 言語では、 この コンパイル とい 
う 作業が なくなる わけです。 

プログラム 叫 発では、 このように 使 丨丨丨 する H 語 （ここでは XC > を 中心に ソ 
ース プログラムを 作成す る 時点から、 どのような 開発 5! 境が あり、 どのよう 
にして 次: 行" f 能な プログラムを 作成す るの かを 知って お 〈必要が あります。 
Human 68 k オペレーション システムで、 実行 丨丨 f 能な プログラムを 作成す る 
までの 過程には 一定の 手順が あります。 

これは 人き 〈分けて、 （1) ソース プログラムの 作成 ( ED . X ) (2) コンパイル 
( CC . X ) ⑶デ バッグ ( DB . X 、 SCD . X ) という 3 ステップ になって います 0 
ft ステップには、 その TWi に 適した ツールが 川 尨され ています。 

( > 内は 対応す る ツールの 名称です 0 

XC コンパイラを 使 III しての コンパイルの 過程では 、ソースコードを コンパ 
イ ルして 灾 •行 丨丨 f 能 ファイルまで いっきに コンパイルしたり、 また アセンブラ 
ソースコードまでを 出力 するとい うように、 XC コンパイラの スイッチ 指定 
により、 さまざまな 開発 方法が 可能です。 

通常の 開発では、 実行可能 ファイルまでを 生成す るよう にします。 

次に、 プログラム 開発が どのような もの かを T - Ufi に 沿って 説明し ます。 
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通??; の ひ 







つの ア ログ フムに ついては、 上記で 示した ような 過程に より プ C 
成します が、 C 言語に よる プログラム 開発に おいて、 目的と する 
インと なる プログラムと 複数の サブ プログラムを 管理しながら 丨}| 
ければ なり ませ/ V 。 









ム 開発の 流れ 



M 2 は、 Ml に比べて オブジェクトの 符理 という 作龙 が增 えてい ます。 
それでは、 fVW に 示された フェーズの 1 つ 1 つを 説明し ましよう。 

(1) ソース プログラムの 作成 

ソース プログラムは • C という 拡張 7 •を もった ファイル 名で、 ディスク 丨 •.に 

作成し ます。 

X68000 では、 ED という エディタを 使い、 この ソース プログラムの 作成 作 
衆を 行います。 

EI ) は、 フル スクリーン エディタと いって、 カーソルを スクリーン. 丨 •.で f 丨山 
に I 力 かせる ことができ 、効率の よい 編 敗が 对 能です。 

EI ) は、 次のように 起! fJj します。 

詳しい 説明は、 Human 68 k ユーザーズ マニュアルを 参照して ください。 




(2) コンパイル 

ソー スフ ァイ ルは、 そのままでは ただの テキス 卜 ファイルです。 

この C 33 ft で 記述した プログラムを、 X 68000 が 実行で きる ような 実行可能 
ファイルに 変換し なければ なりません。 

これを コンパイル といい、 （：••( 語の 他に 代 衣 的な g 語と しては COBOL や 

FORTRAN などが あります。 

また 行さん に 馴染みの 深い BASIC は、 インタプリタ K 語と いい、 ソース プ 
ログ ラムを 1 命令ず つ 機械語に 餅說 しながら 灾行 します。 

この 他、 インタプリタ には LISP 、 PROLOG などが あります。 
コンパイラと インタプリタには 、それぞれ メリット、 デメリットが あり、 い 
ちがいに どちらが よいと いう わけには いきません が、 使用 H 的に よって 使い 
かたが 興 なって きます。 

コンパイラ ’大 速度が Y - く、 アプリケーション や システムの 開発に 丨丨 丨 1 い 

ている が、 初心者には 向いて いない 0 

インタプリタ… コンパイラ に比べて 次: 行 速度が やや 落ちる が、 開発が 比較的 

容舄 にで き、 初心者には 向いて いる。 
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このように、 コンパイラ、 インタプリタには それぞれの 特技が あります が、 
Ai 近では インタプリタ も かなり 速度が 丨丨 ，丨丨 •.してきて おり •きめの 細かい 処理 





章 お使いになる 前に 



ム 開発の 流れ 



■ 



した 



C から C 言語に 変換す る BASTOC が 用 怠され て 
> ギャップを 解消して います 。 



は 次のように 起動し ます 



に、 コンパイラの 各 フェーズで 必要になる 



すると、 ヘルプ メッセージが 表示され ます 
ツチの 説明が 表示され ます。 



使用法： cc 【スイッチ] ファイル リスト 
/A 警告 レベルの 指定 

/b c a 捃 ソースファイル （•〇 のみの 作成 
/C コメント 行の 保存 
/D マクロ 定義 
/E 繊別 子の 最大 長の 指定 
/Fc リンクの 抑制 

/Fd アセンブラ ソースファイル （ .s) の 出力 ファイル 名の 措定 
/Fo オブジェクト ファイル <•〇> の 出力 ファイル 名の 指定 
/Fs アセンブラ ソースファイル （.s> のみの 作成 
/Fx 実行可能 ファイル 《.X) の 出力 ファイル 名の 指定 
/G0 シンボルの 最大 《 数の 指定 《バー ザ 部） 

/Ga シンボルの 最大 個数の 指定 （AS 部） 

/Gb ハッシュ バッファの 最大 個败の 指定 《BC 部 》 

/Gc スタック 檳査の 指定 
/Gh ヒープ サイズの 設定 

/Gp シンボルの 最大 個 » の 指定 《プリプロセッサ 部） 

/Gs スタック サイズの 玫定 
/I インクルード バスの 指定 
/J char® を unsigned char52 とする 
/Na 32k バイト 以上の auto 変数の 使用れ 可 
/Nf 浮動小数点 演算 ライブラリの 変更 
/N1 ライブラリ バスの 指定 

/Ns ソースコード デバッガ <SCD.X> 用 コ一 ドの 生成 
/0 プログラムの 最適化 
/P プリプロセッサの 出力を ファイルへ 出力 
/Q 同一 コード 文字列の 圧縮 
/T 作業 バスの 指定 
/U マクロ 定鑲の 取り消し 
/V プリプロセッサの 出力を 標準出力へ 出力 
/W BASIC ライブラリの 使用 フラグ 
/X 定義 《 み* 別 子 _STD(^_ を 未定義に する 
/Y DOS バ OCS ライブラリの 使用 フラグ 






1.5 プログラム 開発の 流れ 



<:3> 実行と デバッグ 

コンパイルを 終丫 すると、 次: 行 可能な プログラムが 作成され ます。 

太 能な プログラムは、 たとえば test . c という ファイルを コンパイル する 
と、 test . x という ファイル 名で 出力され ます。 

ここで、 いきなり * A >’ プロンプトから、 f test 0’ と 入力して 実行 させても、 
いっこうに さしつかえありません。 

簡屮 .な プログラムの 垛 介は、 1 丨"| の コンパイルで 完成して しまう 場合 も あり 
ますが、 通常の プログラム 丨》1 発では、 数 丨"丨 デバッグ 作 X : を 繰り返した 後に プ 
ログ ラムを 完成し ます 0 

尖 行 4 能な ブロ グラムの デバッグ 作 菜は、 DB . X または SCD . X という デ ノ< 
ッガを 使って 作業し ます。 



実行時の スピード について 

XC システム ディスクでは、 起! FJjl ^ に FM ? V 源 Ml の デバイス ドライバ （0 P - 
MDRV 2. X ) を 0 S に 組み込んで います。 

その 轱災 、コンパィラで 作成され た プログラムを 文 行中に 常時 FM 音源の 
別り 込みが かかり、 次: 行 スピードが 尨 くなります。 

このため、1，\\1 1 ャ淞を使111しなぃ垛介に限り、〇^ド1〇.5丫5から01^1- 
DRV 2. X を 削除し、 次: 行 プログラムの スピードを 向上させる ことができ ま 
す。 



⑷ オブジ ヱ ク卜の 登録と 管理 

C ふ 沿を 使って 叫％ する うえで もっとも 特技 fK リな ものは、 この オブジェクト 
の W 现 です。 

通?？;、 BASIC などでは サブルーチンは 行 SVJ •で W 理さ れ、 1 つの ファイル 
に 納められて います。 

C 2 沾 での 間 発では、 分別 コンパイルと いって、 矜 機能 ごとに プログラムを 
分別して 開発を 進めて いきます。 . 

Vi ： 成济 みの 各 プログラムは、 XC コンパイラ （次: 際には リンカ） によって 結 
びつ けられ、 1 つの プログラムに まとめ 上げられます。 

この 開発で、 オブジェクトの 答 •理が 必要になります。 

プログラムが SdWft ? •度に 分別され ている、 比較的小 规投な プログラム 間 発の 
場^は さほど 問 姐に なりません が、 分別され た プログラムの 数が 多くなる 
と、 ファイルの 数 も 多くな り、 開発の 効率 も 落ちて きます。 

そこで、 プログラムの オブジェクトを 機能 分野 ごとに まとめて、 1 つの ファ 
イル として 管 坪す るよう にします 0 
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章 お使いになる 前に 






たとえば 、グラフィックス 閲 係の 閲 数は、 すべて 1 つの ファイル にしまい i 
みます。 

そして、 リンク するとき に メイン プログラムが 必要と している プログラム/ 
けを、 そこから 抜き とって リンク するとい うように、 オブジェクトの m 合: 
ァイ ルを 作成す る わけです。 

このような 才 ブジェク トフ ァイ ルの ili •合 ファイルを、 ライブラリ ファイル i 

呼びます。 • 

ライブラリ ファイルを 荇邱 する のが LIB . X で、 ライブラリァンと 呼び： 
す。 ライブラリァンは、 このような 分別 化の 於 所と 一本 化の 技 所を ともに も 
かすた めの ツールです。 

分別 コンパイルした 才ブジ ヱクト ファイルを 拡张 f . L で 示される ライブ: 
リファイ ルに 分鉍 します 0 

ライブラリ ファイルには、 权 敉の ファイルを び鉍で 5 ますから、 デイ レク 
リ I •.からは、 あたかも 1 つの ファイルと して符 理 する ことができます。 
ライブラリ ファイルを 作成して、 間 発の 効率化を はかって 〈ださい。 

なお、 ソースファイルの 狞邱 (こは AK . X を 使 I 丨 1 してく ださい 《 




























CC は、 C 言語で 記述した ソースファイルを コンパイル する コマンドです 0 
第 1 饫でも コンパイラに ついての 概要は 説明し ましたが、 本 伊 •では、 この コ 
ンパ イラを これから 使用され るかた のために、 コンパイラ である CC . 父の 
说 明と 起觔 方法、 さらに、 コマンド ラインの 指定 方法を 説明し ます。 




起動 方法 



第 2 章 コンパイル 



i CC . X のこ 
ル 作業では、 




をぃ ぃます。 

この CC . X を 使って コンパイ ノレを 行います。 



コマンド ラインの 指定 








2.1 起動 方法 



(1) コマンド ラインの 害 式 



CC [< スイッチ〉] < ファイル 名〉 [< ファイル 名 > …… ] 



(2) ファイル 名の 指定 

ファイル 名は、 0 S である Hnman 68 k に 依# します が、 全角 文字、 カタ 力 
ナ 、英数字、 記号を 含む 18 文字 以内の ファイル 名を 指定し ます。 

なお、 0 S では 18 文字のう ち、 はじめの 8 文字の みを 澈別 しています。 

全角 文字は 2 文字と して 扱います。 

拡张 子の 指定は 次のように 指定し ます。 



. c 

C の ソース テキスト ファイル である ことを 示す 拡張 子です 0 
この 拡張 子に よって コンパイル します 0 



B > cc prog.c @] 



. s 

アセンブラの ソース テキスト ファイル である ことを 示す 拡張 子です 0 
この 拡張 子を つけた 場合、 C コンパイラは 起觔 されず、 すぐに アセンブラが 
起# 力され ます。 

また、 コマンド ライン 上に、 . c を もった C の ファイルと、 . s を もった アセ 
ン ブラの ファイルを 同時に 指定した 場合は、 • c の ファイルを 敁 初に コンパ 
イ ルして、 次に . s の ファイルを アセンブル します 0 



B>cc prog.c prog 2. s @ 
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第 2 章 コン ハ。 イル 



2.1 起動 方法 



. b (. bas) 

X-BASIC の ソース テキスト ファイル である ことを 示す 拡張 子です。 

CC コマンド ラインには、 X-BASIC の ソース テキスト ファイルを 指定す る 
ことができます。 

これは 「第 5 取 XBAStoC BASIC プログラム コンバータ j で 詳し 〈説明 
します が、 CC コマンド ライン 上に • b や • bas の 拡張 子を もった ファイルを 
指定す ると、 コンパイラは、 それが X-BASIC の ソース テキス トフ アイ ル 
である ことを 涊濰 して、 X-BASIC の プログラムを 語の プログラムに 
変換し ます。 

後は、 . c の 拡張 子で 説明した 通りに 勋作 します。 



B > cc bprog.b @] 



. 〇 

オブジェクト ファイル である ことを 示す 拡張 子です。 

CC の コマンド ラインでは、 ソース テキス トフ アイ ルと ともに、 コンパイル 
および、 アセンブル 済みの オブジェクト ファイルを 指定す る ことができ ま 
す。 

また、 中. 独で、 この 拡張 •了 •のつ いた オブジェクト ファイルを 指定した 場合 
は、 すぐに リンカが 起# 力され ます。 



B>cc prog.c exs.oQj 
B>cc progl.o @] 



予約 ファイル 名 

次に 示す f •約 ファイル 名を 使って はいけ ません。 

AUX , CON , PRN , LPT , PCM , 

CLOCK , NUL , OPM 

その他、 デバイス ドライバで、 特殊に 使用され ている ファイル 名 も 使って は 
いけません。 
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XC コンパイラは、 コンパイラの 制御に 関する 多くの スイッチが 用意され て 
います。 

スイッチの 指定は ゾ’/ 一’ で 始まり、 1 文字 以上の 英字から なります。 

また、 V ’ かし’ は、 使用す るかた が 自由に 選ぶ ことができ ますが、 原則と し 
て、 V /’ を 使用し ます。 

なお、 これから スイッチの 説明を する うえで スイッチ 記号の 大文字と 小文字 
は 区別して ください。 

* 本節では スイッチの 表記は すべて*/’ により 表記し ます 0 






股 則と して スイッチの 指定は、 ファイル 名の 指定より 前に 記述し ます。 
コマンド ラインは、 以下の ようになります。 



CC 


/< スイッチ 記号 >[< パラメータ〉] 


• • • • 




く ファイル 名〉 


• • • • 

，Ar ビ 1 




尤ロ 



上記の ように、 各 スイッチ とく ファイル 名 > とは、 空白で 分離し なければ な 
りません。 

ただし、 く スイッチ 記号〉 とその く パラメータ〉 の 問には 空白を 入れて はい 
けません。 

もし、 空 ft を 入れて しまう と、 コンパイラは 、く パラメータ〉 を 次の スイ ッ 
チ、 または ファイル 名と して 認識して しまう からです。 
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スイッチの 分類 

XC コンパイラで 使 丨丨丨 できる スイッチは、 すべて cc. X を 実行 するとき に 指 
定 する スイッチです 0 

CC . X は 指定され た スイッチ により コンパイルの 実行を 制御し、 史 に、 CC . 
X 自身が 起 $ 力す る リンカ （ LK . X ) の 制' 御 も 行います 0 
XC コンパイラで 指定す る スイッチは、 次のように 6 つに 分類で きます。 



1. M 適 化に 関する スイッチ 

2. プリプロセッサ に関する スイッチ 

3. 出力 ファイルに 問す る スイッチ 

4. 言語に 関する スイッチ 

5. コード 生成に 閲 する スイッチ 

6. その他の 機能の スイッチ 



HHH スイッチの 機能 

本项 では、 前項で 说 明した スイッチの 分頌 ごとに 機能を 说明 します。 









最適化に 閫 する スイ ッ 



プログラムの ii 適 化 
プログラムを 姑 適 化します 0 

公 適 化は 行われません が、 その 分 コンパイルに かかる 時 問は 短くな ります。 



B>cc /0 func.cQ] 








コメント けの 保む •• 



解説 この スイッチを 指定す ると、 プリプロセッサは テキス トフ アイ ルの 注. 釈を 以 びし 

ます。 

この スイッチは/ P 、 / V とともに 指定され る垛 合に 打 効です 0 



省 略 プリプロセッサは テキスト ファイルの 注. 釈を すべて 削除し ます 







ZD く 識別子 >[= 定数] 



プリプロセッサに M する スイッチ 



機 


有 6 




解 


脱 



マクロ 定義 

この スイッチは プリプロセッサ 命令で ある# define と丨丨 il 様に マクロを 定義し ま 

t 〇 



この スイッチ による マクロ 定義は、 ム4 大 までです。 
21 個 丨丨 からは 無视 します。 



省 略 ソース プログラム 中に 妃述 されて いる# define 命令で 定義され ている マクロ だ 

けが 有効になります。 





第 2 章 コン ハ。 イル 



「/丨< パス 名 > 



プリプロセッサ に関する スイッチ 




丨 パスを 指定 または 変 史 できます 0 
•どに 使用で きます。 

:、 敁大 8 個までで す。 



スを 検索し ます。 



c:¥ include func 



この 例では、 










z ■ 



プリプロセッサに M する スイッチ 



機 


能 




解 


脱 



プリプロセッサの 出力を ファイルへ 出力 

プリプロセッサの 出力 リストを ファイルに 出力し ます。 

ファイル 名は ソースファイルと 同一 名で 拡張 子は • P になります 0 

この 出力 リス 卜は 注釈が 削除され ています ので、 必要な 場合は / C スイッチ も 指 

定 して、 注釈を 残して ください。 

この スイッチを 指定した 場合は、 プリプロセッサ 処理の みで 終了し ます。 



省 略 プリプロセッサの 出力は テンポラリ ファイルに 出力され 、コンパイルの 処理は 絞 

行され ます。 

テンポラリ ファイルは コンパイル 終了 時に 削除され ます。 




この 例では、 プリプロセッサの 出力 リストを func . p に 出力し ます 0 
また、 注釈は 保存され ます。 
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第 2 章 コン ハ。 イル 



r / u < 識別子 >， 



リ プロセッサに W する スイッチ 



機 


有 g 




解 


脱 



マクロ 定義の 取り 消し 



この スイッチは、 プリプロセッサ 命令で ある# undef と N 様に、 <淼 別 子 > で 
指定され た マクロ 定義を 取り 消 して、 未定義と します。 

プリプロセッサは、 ここで 指定され た淼別 子が ソース プログラム 中に 妃述 されて 
いた 場 介、 未 迮 衣の マクロと して 取り扱います。 

この スイッチで、 W 大 20 個までの 淼別 子を 未定義と する ことができます。 

21 個 目からは 無視し ます。 

/ U と淼別 子の 問 には スペースを 入れて はいけ ません 0 
また、 以 ドに 示す 定箱济 み マクロを 取り； しては いけません。 



STDC 」 — VERSION — — LINE — — FILE — 一 ，—— TIME 

DATE 



省 略 ソース プログラム 中に 妃述 されて いる# undef 命令に よる マクロ 定莪の 取り消 

しのみ が 釘 効と なります。 



例 




B〉cc /Dval 1 = 100 /[ 


) val 2 = 200 / Dval 3 = 300 /Uvall func.c @] 



この 例では、 識別 户 vail のみが 米 定義と なります。 
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ツサの 出力を 標準出力へ 出力 







) 



チを 指定す る ことにより、 プリプロセッサは 出力 リストを 標鵰 出力に 

0 

ストは 注釈が 削除され ています ので、 必要な 場合は / C スイッチ も 指 
を 残して ください。 

チを 指定した 場合は、 プリプロセッサ 処理の みで 終了し ます。 

ッサの 出力は、 テンポラリ ファイルに 出力され、 コンパイルの 処理は 
す 。 

ファイルは、 コンパイル 終 に 削除され ます 0 







出力 ファイル に関する スイッチ 



機 






解 


脱 



リンクの 抑制 

この スイッチの 指定に より、 CC . X は リンカを 起動せ ずに、 オブジェクト フ アイ 
ルの みを 出力して 終了し ます。 

出力され る オブジェクト ファイルは 、ソースファイル 名の 拡張 子を • 0 に; K き換 
えた ファイル 名になります 0 



省 略 | CC . X は リンクまで 実行し、 実行可能 ファイルを 作成し ます。 




「/ Fd く ファイル 名 > 



力 ファイル に関する スイッチ 



機 能 



アセンブラ ソースファイル （. s > の 出力 ファイル 名の 指定 



解 説 この スイッチと それに 絞く ファイル 名を 指定す る ことにより、 アセンブラ ソース 

ファイルを 指定され た ファイル 名で 出力し ます 0 
この スイッチは、/ Fs スイッチと ともに 指定した 場合に イ i 効です 0 



省略 /Fs スイッチを 指定した 場合、 カレント ディレクトリ I •.に ソースファイル 名と 

M —名で 拡張 子が、 .s の アセンブラ ソースファイルを 出力し ます 0 



例 




B>cc , 


/Ps / Fdc :¥ usrl ¥ sample ¥ sample.s sample.c 0 



この 例では、 ソースファイル saniple . c を コンパイルして 作成され た アセンブラ 
ソース プログラムを、 c :¥ usrl ¥ sample ¥ sample . s という ファイルに 出力し ます 0 
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第 2 章 コン ハ。 イル 



r/F〇< ファイル 名：^ 



出力 ファイル に関する スイッチ 



機 有 巨 オブジェクト ファイル （.0) の 出力 ファイル 名の 指定 



解脱 この スイッチと それに 絞く ファイル 名を 指定す る ことにより、 オブジェクト ファ 

イ ルを fit 定 された ファイル 名で 出力し ます 0 



省 略 カレン 卜 デイ リク トリ 上に オブジェクト ファイルを 出力し ます 0 




この 例では、 ソースファイル sample . c を コンパイルして 作成され た オブジェ ク 
卜を、 c :¥ usrl ¥ objs ¥ sample . o という ファイルに 出力し ます。 
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出力 ファイル に関する スイ ッ 



•ラ ソースファイル （. S ) のみの 作成 

ルを 実行し、 アセンブラ ソースファイル （. S ) が 作成され ます 0 
ワレ •リンクは 実行され ません。 



ル、 アセンブル、 リンクの すべてが 行われます 0 
，ラ ソースファイルは 作成され ません。 






第 2 章 コンパイル 



/ Fx く ファイル 名 > 力 ファイルに M する スイッチ 



機能 実行可能 ファイル （. x > の 出力 ファイル 名の 指定 



解 __ 脱 | この スイッチと それに 絞く ファイル 名を 指定す る ことにより 実行可能 ファイルを 

指定され た ファイル 名で 出力し ます 0 



省 略 I CC . X 起觔 時の コマンド ライン 上に ili 初に 指定され た ソースファイル 名に 拡張 子 

X がつ いた ファイル 名と して 出力し ます。 




この 例では、 ソースファイル sample . c を コンパイルして 作成され た 実行可能 プ 
ログ ラムを、 c :¥ bin ¥ sample . x という ファイルに 出力し ます 0 
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首 語に M する スイ ッ 





ほ 勋小数 点演兗 ライブラリの 変史 

浮 勋 小数点 演算 ライブラリを FLOATEM し L に 変 史 します。 

デフ オル 卜の FLOATFNC. L を 使 ⑴し た 場合は、 FLOAT?. X (FL0AT2. X な 



ど〉 が 組み込まれて いなければ、 実行で きない 実行 ファイルが 作成され ます。 



FLOATEM し L を 使 ⑴ した 場合は、 FLOAT?. X が 組み込まれて いなくても 実 
行 可能な 実行 ファイルが 作成され ますが、 FLOAT?. X を 使用す る 実行 フ アイノ レ 
に比べて ファイル サイズが 人き くなります 0 



省 略 1 汴承 力 小数点 演 W ライブラリは FLOATFNC. L を 使 Jfj します。 
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「/NI く パス 名〉 



言語に 関する スイッチ 










言 H に関する スイ ッ 



機 能 I ソースコード デバッガ （ SCD . X ) 用 コードの 生成 

解 脱 1 ソースコード デバッガ SCD . X による、 ソース プログラム レベルでの デバッグを 

可能に する ために、 実行可能 ファイルに デバッグ 悄 報を 付加して 出力し ます。 
この スイッチを 指定す る 場合は、 以下の スイッチを 同時に 指定して はいけ ませ 
ん 0 

/0 /Gh /Gs 



省 略 | デバッグ 情報は 付加され ません。 
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ヘンク 検査の 指定 

> スイッチが 指定され ると、 プログラム 実行時に スタック 領域に 十分な スぺ— 
f あるか どうかを チェック する コードを 実行可能 ファイルに 付加し ます 0 
な スペースがない 場合には、 その 旨の メッセージを 表示し ます。 

ック チェックを 行いません。 

ック チヱ ックを 行わない と、 スタックが オーバーフローを 起こす 可能性が あ 
すが I 実行 速度は、 スタック チェックを 行う コードを 含まない 分 高速です。 



>cc /Gc func.c @] 






/ Gh < サイズ > 



ド 生成に W する スイッチ 



機 



能 



ヒープ サイズの 設定 



解 説 j 実行時の ヒープ サイズを 1 バイト もしくは 1 K バイト 単位で 指定し ます。 

malloc 関数な どで、 大きな 領域が 必要な ときに この サイズを 大きく とる 必要が 
あります。 

ヒープ サイズの Ai 小 値は 8 K バイト、 敁大侦 は メモリの サイズに よって 変わり ま 
す。 



省 略 



デフ オルトの ヒープ サイズは 64 K バイトです 0 




この 例では、 ヒープ サイズを 128 K バイトに 設定して います。 



62 









第 2 章 コン ハ。 イル 



/ Gs < サイズ > 3 _ 



ド 生成に 閧 する スイッチ 



機 


有 g 




解 


説 



スタック サイズの 設定 

次: 行 時の スタック サイズを 1 バイト もしくは 1 K バイト 単位で 指定し ます 0 
プログラムで、 リカーシブ ル コール （再* W 呼び出し） を 多用して いる 場合な どで 
は、 実行時の スタックを 大站パ こ消赀 する ため、 この スイッチ により スタック サイ 
ズを 大きく とって おく 必要が あります。 

スタック サイズの M 小侦は 4 K バイト、] 大侦は メモリ サイズに よって 変わり ま 



t 〇 



省 略 デフ オルトの スタック サイズは 64 K バイトです 0 



例 



B>cc / Gs 90 k func.cS 



この 例では、 スタック サイズを 90 K バイトに 設定して います。 
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背告 レベルの 指定 

ワーニング エラーの 構文 チェック レベルを 指定し ます 0 
構文 チェック レベルの 範囲は、 1 〜 3 です 0 



各 レベルの 内容は 次の 通りです 0 



レベル 1 通常の 構文 チェック レベルで、 ワーニング エラーを 出力し ます。 

レベル 2 …… 明示的な 5? 変換が 発生した ときに、 ワーニング エラーを 出力し ま 

す。 

レベル 3 …… 暗黙 的な 型変換が 発生した ときに、 ワーニング エラーを 出力し ま 



省 略] 構文 チ ヱツ クレベルは レベル 1 です 0 







その他と 機能の スイ ッ 





c 言語 ソースファイル （. 〇 のみの 作成 

この スイッチを 指定した 場合、 コマンド ラインには X - BASIC の ソー スフ アイ 
ルを 指定し ます 0 



その 場合、 C 言語の ソースファイルを 出力して コンパイルを 終了し ます 0 



C 言語の ソースファイルは、 コマンド ラインで 指定した X - BASIC の ソー スフ 



アイ ル 名の 拡張 子を . C で 策き 換えた ファイル 名で 出力し ます 0 



省 略 | C 言語の ソースファイルを 出力して、 コンパイルを 最後まで 実行し ます 0 
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淼別 子の Ai 大技の 指定 

C 言語の 淼別 子の Ji さを 指定し ます。 
長さは、 8 〜 32 の範 M で 指定し ます。 



省 略] 識別子の Ai 大鼓は 32 です。 
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char S を unsigned char 型と する 



その他の 機能の スイ ッ 



解脱 char 型は、 デフ オルトでは 符号 付きと なって いますが、 この スイッチを 指定す 

ると デフ オルトを 符号な し （ unsigned 〉 に 変 史 します。 

したがって、 char の侦を int に 拡張した 場合、 この スイッチを 付けない と 符号 
拡张 されます が、 付ける と 符号 拡張され ません。 



char 型を 符号 付きと します。 







その他の 機能の スイッチ 



機 




同一 コード 文字 例の E 縮 




脱 


プログラム 中に、 同じ 内衫の 文字 例が 初期値と して 複数個 使用され ていたと き 
その 文字 例を 1 つ だけに 圧縮して、 コンパイル します。 


省 


略 


圧縮は 行われません。 



例 




B>cc , 


/Q func.c 0] 
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作業 パスの 指定 

コンパイル 時に 使用す る 作業用 ディレクトリを 指定し ます 0 



省 略 | 環境 変数 temp で 指定され た パスと なります。 

S 境が 指定され ていない 場合は、 カレント ディレクトリと なります 0 
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D 0 S /10 CS ライブラリの 使用 フラグ 

この スイッチを 指定す る ことにより DOS / IOCS の ライブラリ 
IOCSLIB . L ) を リンカが 涊淼 します。 



( DOSLIB . L ， 



省 略 I リンク 時に DOSLIB 丄と IOCSLIB 丄を 使用し ません。 





その他の 機能の スイ ッ 



機能 BASIC ライブラリの 使用 フラグ 



解 脱」 この スイッチを 指定す る ことにより BASIC ライブラリ （ BASLIB . L ) を リンカ 

が涊淼 します。 



省 略 BASLIB . L を リンク 時に 使用し ません。 



例 





/ G 0< シンボル 数 > 




シンボルの Wr 大 個数の 指定 （パーザ) 




パーザが 処理す る シンボルの、 敁大 個数を 指定で きます。 
シンボルの W 大 個数の 範洲 は、 以下に 示す 通りです。 

400 S シンボル 数 S 65535 



省 略 



デフォルトの シンボル 数は、 3000 個です 0 
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n / Ga く シンボル 数 > 





シンボルの ム i 大 個数の 指定 （ AS 部） 

AS が 処理す る シンボルの Wr 大 個数を 指定で きます。 
シンボルの J 丨 i 人 個数の 範间 は、 以下に 示す 通りです。 



270 S シンボル 数 S 32768 



省 略 j デフォルトの シンボル 数は、 2000 個です 0 
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「ノ く バッファ 数> 

ハッシュ バッファの 敁 大 個数の 指定 （ BC 部〉 

BC が シンボルを 処理す るた めに 使用す る ハッシュ バッファ （1997 個の エン ト 
リ〉 の、 Air 人 •個数を 指定で きます。 

ハッシュ バッファの 敁人 個数の 範丨 用は、 以下に 示す 通りです。 

1 S バッファ 数 S 32 

シンボル の敁人 個数は、 1997X バッファ 数と なります。 

デフォルトの バッファ 数は、 1 個です 0 






第 2 章 コンパイル 



r/Gp く シンボル 数 > 



その他の 機能の スイッチ 



レの Ai 大 個数の 指定 （プリプロセッサ 部) 

I セ ッサが 処理す る シンボルの 敁 大個 数を 指定で きます 0 
レの 极大 個数の 範丨 相は、 以下に 示す 通りです。 

シンボル 数 S 65535 

レ 卜の シンボル 数は、 200 Ofl 占 I です。 









その他の 機能の スイッチ 



32K バイト 以上の auto の 変数の 使用許可 



32K バイト 以上の auto 変数を 使用で きます。 

ただし、 32K バイト 以上の auto 変数を 使用した ときは、 胬告 メッセージが 表示 
されます。 

この スイッチを 肖 略した ときは、 32K バイト 以上の auto 変数を 使用で きません 0 
32K バイト 以上の auto 変数を 使 川した ときは、 エラーメッセージが 表示され ます。 



test.cQ] 








その他の 機能の スイ ッ 





プリプロセッサの 定義 済み 淼別 子 STDC を 定義し ません 

mmm 



解 脱 プリプロセッサの 定義 済み 淼別子 __ STDC __ を 定義し ません。 

その 結泶 、標準 ライブラリ 関数は プロトタイプ 宣言され ません。 
標準 ライブラリを 使 川 するとき、 引数の® チェックを 行いません。 



省 略」 プリプロセッサの 定義 済み 淼別子 __ STDC — は 1 に 定義され ます。 

その 結果、 標搫 ライブラリ 関数は プロトタイプ 宣言され ます。 

標準 ライブラリ 関数を 使 JH するとき は、 引数の 5? チェックを 行います。 
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作業用 ファイル 



ァ センプル 



本節では、 XC コンパイラの アセンブラ （ XAssembler ) について 溉 要を 説 
明し ます。 

詳しい 説明は、 「アセンブラ マニュアル」 を 参照して ください。 

HHB ァセ 使ぅ 入出力 ファ ィル 

アセンブラを 実行す るう えでの ファイル 構成と 内衫 について 説明し ます。 



入 カフ 



出 カフ 
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第 2 章 コンパイル 



2.3 アセンブル 



⑴ 入力 ファイル 

人力 ファイルには 、ソースファイルと インクルード ファイルの 2 神 類が あり 
ます。 



ソースファイル 

アセンブリ 语 の ニー モニックで , k ! 述 された プログラムが 格納され ている フ 
ァイ ルです。 

インクルード ファイル 

これ も ソースファイルで すが、 ft プログラム 問で 共通に 使丨丨 I する シンボルな 
どを 定在 するとき に 使 Ml します。 

インクルード ファイルを 使 川 するとき は、 アセンブラの ソース プログラム 屮 

に .include 疑似 命令を 記述し ます 0 

この 指定に より インクルード ファイルの 内 V ? が ソース プログラム 屮に神 入 さ 
れ るので、 プログラムの コーディングの 手 IK 1 が VT ける とともに、 プログラム 
間 発の A 産 性が 向上し ます。 

(2> テンポラリ ファイル 

これは、 アセンブル 時の 作 龙丨丨 1 ファイルです 0 

アセンブル 時には テンポラリ ファイルが 常に 作成され ますので、 アセンブル 
が終丫 する まで フロッピー ディスクを とりはず L てはいけ ません。 
アセンブルが 終 r すると、 テンポラリ ファイルは 的に 削除され ます。 
なお、 テンポラリ ファイルの パス 名は® 境 変数 temp より 参照され ます。 
ただし、 / t スイッチで 指定され た坳 合は、 こちらの 指定が 俺 先され ます。 



(3> 出力 ファイル 

出力 ファイルには、 才 ブジェク トフ アイ ルと リス トフ アイ ルの 2 钝妞 が あり 
ます。 



オブジェクト ファイル 

アセンブル 処邱 によって 作成され た オブジェクト プログラムを 格納す る ファ 
イ ルです。 

オブジェクト ファイル 名は、/ 〇 スイッチで 指定し ます。 

tit 定 がなければ、 アセンブラは ソースファイルの 拡張 子 . S を •〇 で; K き 換え 

た ファイルを n 勋的に 作成し ます 0 
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2.3 アセンブル 



リスト ファイル 

アセンブル リストを 格納す る ファイルです。 

リスト ファイル 名は、 / p スイッチで 指定し ます。 

/ p スイッチ のみを 指定して リス 卜 ファイル 名を 指定 しないと、 アセンブラ 
は ソースファイル 名の 拡張 子 s を prn で 置き換えた ファイルに 自勋 的に 作成 
します。 



セン ブラの 使用 書 g 



アセンブラは 次の？! ••式で 使用し ます。 



as [< スイ ツチ >] < ソースファイル 名 > 



H 3 Q アセンブラの スイッチ 

アセンブラ 実行時に、 アセンブル 時の 觔 作を 制御したり、 アセンブラに 必要 
な悄 報を 与える ために、 コマンド ライン 上に 指定す る 英字 1 文字を スイッチ 
といい ます。 



B>as /t 


¥tmp / c 


►objout source (3) 

-T I ^ 




a q 7 フ 
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XAssembler には 以下の 




シンボルの 逸 別 長を 8 バイトに する 

絶対 ショート アドレス 形式 対応 モード 

すべての シンボルを 外部 定義す る 

インクルードの パス 指定 

敁大 シンボル 数 

敁適 化の 禁止 

オブジェクト ファイル 名 

リス トフ アイ ル 

シンボルの 定葙 

テンポラリー パス 指定 

未定義 シンボルを 外部 定義に する 

ワーニング ェラーの 出力 禁止 

シンボルの 出力 







本節では、 リンカ （ XLinker ) についての 槪 要を 説明し ます。 

詳しい 説明は、 「アセンブラ マニュアル j を 参照して 〈ださい。 

リンカとは、 アセンブルした オブジェクトを リンクして 実行可能 プログラム 
を 作成す る ツールの ことを いいます 0 
リンカの 機能は、 次の 通りです。 

(1) 別々 に アセンブルした オブジェクトを 結合し ます。 

(2) 未定義の 外部 参照を ライブラリ ファイルから 探し、 外部 参照を 解決し ま 
す。 

(3) 外部 参照の 解決 や ェラーメッセージを 示す リストを 作成し ます。 

高級 言語で ある C などの コンパイラで 作成した アセンブラ ソース や、 初め 
から アセンブラで 作成した ソースは、 いったん アセンブルされ ると、 丨 Hj —に 
扱う ことので きる オブジェクトになります。 

通常、 開発は プログラムを 枚数の モジュールに 分剂 して 作成 •アセンブル、 
その後に まとめ 上げる という 手法を とります。 

たとえば、 C 言語で プログラムの 大半、 特に アルゴリズムの 中心部 分を 作成 
し、 細かな 制御が 必要な I / O に閲迚 する 部分を アセンブラで 作成し、 これ 
らを 組み合わせるな どです。 

このように、 オブジェクトを まとめて 1 つの 実行可能 プログラムを 作成す る 
ことが リンカの 働きです。 

また、 C 言語な どでは、 関数の 多くが オブジェクトの 形式で ライブラリ とし 
て サポートされ ている ので、 そのため にも リンカが 必要です。 

リンカは 、分別され ている 沒 数の オブジェクトを まとめ 上げます。 

このと き、 別の オブジェクトの 一部を 利 用 する ルーチンを 参照したり、 ライ 
ブラ リ関 数を 参照 するとき には、 まず、 オブジェクトを fid 策して 1 つに まと 
め 上げ、 次に 外部の 参照の 関係を 正しくし ます。 
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2.4 リンク 



リンカで 使う 人出 力 ファイル 

リンカは、 入力、 出力 および テンポラリ ファイルを 使用し ます 0 



(1) 入力 ファイル 



種 類 


拡張 子 


作成 経 a 


オブジェクト 


0 


コンパイラ または アセンブラ 


アーカイブ 


a 


アーカイバ 


ライブラリ 


1 


ライブラリアン 



(2) 出力 ファイル 



1 

種類 


拡張 子 


使用 目的 


灾行 ファイル 


X 


プログラム 実行 


マップ ファイル 


map 


参考資料 



(3) テンポラリ ファイル 

リンカは、 次: 行 可能 ファイルの 作成に 使 川す る データの 保持に 記惊 領域を 使 
川 可能な かぎり 使います。 

ここで 処理す る オブジェクトが 大きい 場合、 リンカは さらに 記惊 領域を 必要 
とします。 

そこで、 ディスクに テンポラリ ファイルが 自 ： S 力 的に 作成され ます 0 
このように リンカは テンポラリ ファイルを 作成す るので、 この 処理が 終了す 
るまで フロッピー ディスクを とりはずし てはいけ ません。 

リンカが 終了す ると テンポラリ ファイルは 自！ 1カ 的に 消去され ます 0 
このため 通常の 使 Hj では、 この ファイルは 必ず 作成され るので、 あらかじめ 
十分 使用可能な ディスク 容 W ： を ディスクに とって おかなければ いけません 0 
そこで、 テンポラリ ファイルを 作成す るた めの パスを 指定して おく ことが で 
きます。 

テンポラリ ファイルの 指定には、 / t スイッチを 使用し ます 0 
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B>lk / tb ： temp pp @] 

テンポラリ ファイル 指定 



/ t スイッチ によって テンポラリ ファイルを 指定 しないと きは、 環境 変数 
temp を 参照し ます。 

temp の 指定が あっても、 / t スイッチ による 指定が あれば、 スイッチの 指 
定を優 光し ます。 



ン 力の 使用 書式 



は、 次の 畜 式で 使用し ま 



卜 ファイル 名は、 权 数個 指定で きます 0 
ジェク 卜 ファイル 名の 他に、 才 ブジェク 
も 指定で きます。 

ファイルを 指定す ると、 リンカは 自勋的 
ク 卜を 探します。 










本飫 では、 XC コンパイラ によって 作成され た灾行 可能 ファイルの 実行に 関 
する 説明を します。 




第 3 章 プログラムの 実行 



実行 方法 




XC の ソースファイルは、 コンパイル されて. X という 拡張 子の ついた 実行 
可能 ファイル として 出力され ます。 

この 実行可能 ファイルは、 プロンプトから 拡張 子 . x をつ けないで、 入力す 
る ことにより 実行す る ことができます。 



B > sample @] 



上記の 例は、 sample . x という 実行可能 ファイルを 実行した ところです 0 
次: 行 可能 ファイルは、 X 68000 の OS 、 Human 68 k の 実行可能 ファイル とし 
て 勋 作し ます。 
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fiij 帝では、 CC . X の コマンド ラインに ついて 説明し ました。 

本節では、 ユーザーが C 誇 語に よって 作成した 実行可能 ファイルの コマン 
ドラ インに ついて 説明し ます。 



mi デ- タをプ □グラムへ わたす 方法 



c rus で 作成す る プログラムは、 次: 行 するとき に丨 ⑴ 時に データを 引き わたす 
ことができます。 

これは、 コマンド ライン I •.に 文 行 可能 ファイル 名と MB をに 入力す る ことによ 
り 次: 呪で きます。 



B > sample 20 prog @] 



1 ••記の 例は、 sample という プログラムに、’ SO ” と’’ prog ” という データを わ 
たし、 次: 行して いる 例です。 

れ データを 人 乃 するとき は、 1 つ以丨 •.の •个: fl か TAB によって K 切らな けれ 
ばな りません。 

データ 中に •今: 广彳 を 人力す る 堝 合は、 クォーテーションマーク n により、 
Kyj る 必要が あります。 



B > sample 100 ’’func 25’’® 



ヒ 記の 例では、” 100” という データと ” func 25” という データを sample にわ 
たす ことを 总 味して います。 

この sample という プログラムの main 丨 対数は、 ユーザーから データを 受け 
« (る 関数に なって います。 

このような データを 受け取る main 関数は、 次のように 宣言す る 必要が あり 
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コマンド ラインは、 そのまま argv 文字列の データと して main 関数に 引き 
わたされます。 

コマンド ライン h の データの 数は、 argc にわた されます。 

次の例では、 







本饮 では、 C / f 雄と アセンブラを リンクす るう えで 必要になる インター フエ 
について 説明し ます。 

では 次:％ しづら い プログラム、 たとえば ハードウェアを 細かく 操作し 
tn ばなら ないような プログラムを 作成す る垛 介、 次: h •スピードの げ丨丨 から 
アセンブラで 作成した 方が、 より 効災 的です。 

••中 •純に 次: 行 スピード だけを 迟 求す るよう な プログラム にもい える ことで 



コンパイ ラでは、 このような ニーズを 芩遂 して c 3 雄と アセンブラを リ 
する ことができます。 

、本饮 では、 アセンブラと xc の インターフェイスを 一通り 説明した あ 
簡琳 な加贫 関数の いくつかの 作成 パターンを 例に とって 説明し ます。 



第 4 章 アセンブラとの インター フ 




本節では、 c 言語の プログラムと アセンブラの ブロ グラムを リンクす る 場 
合、 アセンブラ プログラムで インターフェイスを どのよう にと るかを 説明し 
ます。 

インターフェイスを 大きく 分ける と、 次のようになります。 



(1) ブロ グラムの 入口と 出口 

(2) 引数の アクセス 

(3) 戻り 値の 投定 

⑷ グローバル 変数の アクセス 

(5) 名前の 規則 

(6) その他の 注意 



QQQ プログラムの 入口と 出口 



入 ロ 

一般的に、 プログラムの 入 n では、 次の ような 宣言 や 準備を 行う 必要が あり 
ます。 



① 関 数名を 宣言す る …… xdef 命令 使用 

② 引数を 受け取る 准 備を する …… offset や equ 命令で 宣言す る 

③ auto 変数を 確保す る 
例 



link a 6,# AUTOSIZE 



④ レジスタを 返 避す る 
例 



d 3- d /， ajmsp ) 








4.1 アセンブラ インターフェイス 



出 ロ 

プログラムの 出 n では、 次の ような 手 絞き を 踏まなければ なりません。 

①入丨 1 で セーブした レジスタを 很妯 する 
例 



movem.l ( sp ) + , d 3- d 7/ a 3- a 5 



② auto 没: 数を 解放す る 
例 



unlk a 6 



③ 呼び出し 元に 戻る …… rts 命令を 使う 

引数の アクセス 



引数の アクセスでは、 呼び出し 元の 引数が どこに 格納され ている かを 知る 必 
要が あります。 

一般的に 引数は、 スタック フレーム という スタック 領域の 中に 格納され てい 
ます。 

以下に スタック フレームの 例を 示します。 

C 首 語での 間数 仕様 



sample (int argl, int arg 2 , int arg 3) 



上記の ような 引数の 場合、 次の ような スタック フレームになります。 
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引数のと り 込み 方 

上記の ような スタック フレームの 垛合 、次のように 引数を とり 込みます 0 
また、 スタック フレームに 格納され た 引数の 相対値は、 次のように offset 
や equ などを 使い、 わかりやす くして おいた ほうがよ いでし よう。 

例 





. offset 


4 


argl 


ds.l 


1 


arg 2 


ds.l 


1 


arg 3 


ds.l 


1 




. text 





savesize 



迟避数 > 








arKl(a6) f dO-dl 

argl(sp),d〇-dl 

ar^l -f savesize(sp) f dO-dl 



argl(a6>,d0_dl/a0 ① 

argl(sp) f dO-dl/aO ② 

argl +savesize(sp),dO-dl/aO ③ 



こむ 場合 



かの 引数を 一度に 



double 型の 塌合 



argl(a6) f d0 ① 

argl(sp)，dO ② 

argl 十 savesize(sp>,dO ③ 



t 、 short 、 char 、 ホ インタ、 float 型の 引数の 場合 

〇 変数 使用 時 

〇 変数を 使 丨丨丨 せず、 かつ レジスタの 退避 もしない 場合 
〇 変数を 使 I 丨丨 せず、 レジスタ 退避を した 場合 



①②③ 













第 4 章 アセンブラとの インターフェイス 



4.1 アセンブラ インターフェイス 



un 戻り 値の 設定 



•り 姐の 設走 方法は、 設定す る 切に よって 興 なって きます。 
設定 方法を 次に 示します。 



型 名 


設定 方法 


1 

char 型 


dO の ド 位 8 ビットに 設定し ます 


short 5? 


dO の 下位 16 ビットに 汶定 します 


int 型 


dO に 設定し ます 


float ¢1 


dO に 設定し ます 


double 型 


dO 、 dl に 設定し ます 


ポインタ 


dO に 設定し ます 



» char , short , int 型に 関しては unsigned タ イブで も 同じ 設定 方法です。 



グロ一 バル 変数の アクセス 



グローバル 変数への アクセスは、 その 変数が 格納され ている アドレスより 丨 (V 
接 説み 込み/普き 込みを 行います。 

グローバル 変数の 読み込み 方 

グローバル 変数を 説み 込む ときは、 その 変数が 外部 モジュールで 宣言 （領域 
確保） されて いる 場 介、 次の ような 外部 参照 名の 茛 言を 行う 必要が ありま 



xref name 



次に 読み込み 方の 例を 示します。 
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第 4 章 アセンブラとの インターフェイス 



4.1 アセンブラ インターフェイス 



(3) 配列、 構造体 変数の 場合 

これらの 吧 は、 iv 皮 数の： t 姐の アドレスを 次のように 说み 込みます 0 



lea name . aO 



変数 のれ 要桌を 参照す るには、 . Uil の アドレス レジスタ （ a0> を 使 丨丨丨 しま 

t〇 



例 1 




arry：8： ; ① 



lea arry. a() 

move . 1 12 ( aO ). dO 




② 



move . 1 12+ arry . dO ③ 



① のよう な C の fill 列 穴 • j の 場 作に、 rti ! 列 要ぶ arry [3] を 参照 するとき の 例 
が、 ②と③ です。 

このと きの デイ スプレー メント は、 4 (int W の バイト 数 > X 3 ( 添 卞 > =12 
です。 

② と③ は M じ fift を说み 込みます ので、 坳れ により 使い分けて 〈ださい。 
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4.1 アセンブラ インターフェイス 



例 2 



struct 


sample { 1 




int x ; 

char c ; 

} smpl [4] ; 


④ 


lea 


— smpl， aO 又 


…… ⑤ 


move , b 


22 ( aO ), dO ^ 


move , b 


22+_ smpl , dO 


⑥ 



④ のよう な C の满 造沐を 要ぶ にもつ 紀 列 h 3 の垛 合に、 配列 要 本の 構造体 
メンバ smpl [3 ].c を 参照 するとき の 例が、 ⑤と⑥ です。 

このと きの デイ スプレー メン 卜は、 6 (sizeof (struct sample ) の 侦> x 3 
(添字 > +4 ( メンバ c の オフセット > =22 です 0 

⑤ と⑥ は M じ 侦 を说み 込みます ので、 場合により 使い分けて ください。 

注： MPU 68000 では、 分数 アドレスから 始まる ワード、 ロングの データ ア 
ク セスは できません での （アドレス エラーが 発生す る）、 W 造 体の メン 
バに char 喟 （バイト データ） が 含まれる 場合は、 自觔 的に ワード 境界 
の 凋 祭を コンパイラが 行います。 

したがって、 そのような 梆造 体を アセンブラで アクセス する 場合は、 注 
5: が 必要です。 
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第 4 章 アセンブラとの インターフェイス 



4.1 アセンブラ インターフェイス 



mu 名前の 規則 



アセンブラの ラベル 名のつ け かたを 説明し ます 0 

たとえば、 C で smpl という 淼別 子は アセンブラでは __ smpl というよ うに、 
ラベル 名の 前に“” をつ けます 0 

また、 アセンブラの 命令 ( こ ある 名丨 iij ( move や sp > は 使えません。 




アセンブラ プログラム 内で 壊して よい レジスタと、 壊して はいけ ない レジス 
タ があります。 

C で 使用す る レジスタ 変数は、 d 3/ d 4/ d 5/ d 6/ d 7、 a 3/ a 4/ a 5 です。 

また、 システムでは a 6/ a 7 を 使用して いるので、 アセンブラ プログラム 内 
では d 0/ dl / d 2 と、 a 0/ al / a 2 は 垓しても かまいません。 
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アセンブラ プログラム 例 



本節では、 簡中 •な 加兑聞 数を アセンブラで 作成す ると どのようになる かを 
かの パターンを 例に とって 紹介し ます。 

:: からの 呼び出し 形式を 示します。 



addsub (int srcl, int src 2. 




この 関数の 機能は、 srcl と src 2 を 加 兌して dst に 格納し ます。 

また、 この 関数の W り 侦と して 、 srcl — src 2 の 侦 を 返す ことにな り 



a 6/ a 7 以外の すべての レジスタを 使⑴ する 場合で、 auto 変数を 使用 
引数のと り 込みを いろいろな ところで 行う 場合。 



AUTOS IZE 









. xdef addsub 

•offset 8 

src 1 ds • 1 

src2 ds • 1 

dst ds • 1 

AUTOSIZE 
ret 



equ 

equ 



-4 

-4 



. text 



* int add8ub( srcl f src2 9 dst ) 

* arguments 1 offset 

* int srcl ； 

* int src2 ; 

* int tdst ； 



addsub 

link a6 f #AUTOSIZE 



auto int 



ret ； 




00-02/八0-六2のレジスタのみ使用可 



move • 1 
movea • 1 
move . 1 
move . 1 
move • 1 
add.l 
sub. 1 
move • 1 

unlk 

rts 



srcl (a6 ) f d0 
dst(a6) f a0 
d0 f (a0) 
dO f ret ( a6 ) 
src2 ( a6 ) i dO 
d0 f (a0) 
dO , ret ( a6 ) 
ret ( a6 ) f d0 

a6 





*dst = srcl ； 
ret = srcl ； 

*dst += src2 ； 
ret •= src2; 
return( ret ) ; 



• end 






















move 
rts 
• end 






使用 可 
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例 4 

dO-d2/aO-a2 
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XBAStoC BASIC 

プログラム コンバータ 



BASTOC とは 
プログラムの 作成の 流れ 

変換 方法 

BASTOC での BASIC プログラムの 書き かた 

BASTOC の ファイル 構成 




本 帝では、 BASIC プログラムから C 言語の プログラムへ 変換す る コンバー 
タ、 XBAStoC (以下 BASTOC と 呼びます） の 説明を します。 

通常の X - BASIC の プログラムを そのまま 変換しても かまいませんが、 変 
換 後、 C の コンパイルを 行うた め、 X - BASIC の プログラムに 多少の 制限 啪 
頌 をもう けて あります。 

BASTOC の 利用を 前提に X - BASIC の プログラムを 作成す る 場合は、 「5. 4 
BASTOC での BASIC プログラムの？ T きかた j を あらかじめ お 説み くださ 




第 5 章 XBAStoC BASIC プログラム コンバータ 



B ASTOC と は 



BASIC は、 もともと 初心者 向けに 作られた 言語で あり、 その 開発の 容易 さ 
により、 古くから 多くの ユーザ一に 親しまれて きました。 

X 68000 の X - BASIC も Human 68 k 上で 走る インタープリタ BASIC であ 
り、 促 米の BASIC を さらに 強化し、 関数 定義 や ローカル 変数の 扱い、 さら 
に、 データ® の サポートと いった、 きめの 細かい 処理を 可能に しています。 
なお、 X - BASIC の 詳しい 説明は 、 “BASIC マニュアル” を 参照して 〈ださ 

い 0 

この X - BASIC で •记述 した プログラムを CHrift に 変換す る コマンドが、 こ 
こで 说明 する BASTOC です。 

BASTOC は “ BASic TOC ” の 人文字を とった 略で、 X - BASIC のプ ログ ラ 
ムを 組む ことは できます が、 C 言語は 初心者、 というよ うな かたに W 適な コ 
マンドです 0 

また、 X - BASIC である 程度 デ バック 作龙を 行い、 完成した あと 一括して C 
言 雄に 変換す る こと も 可能です 0 
以下に BASTOC の特 於を 示します。 



BASTOC の 特長 

① XC コンパイラと 同様に、 コマンド ラインに より 灾行 する ことができ ま 
す。 

② BASIC と 同等の 関数が 用意され ています。 





プログラムの 作成の 流れ 1 



本節では、 BASTOC を 使って プログラムを 作成す る 場合の 流れを 説明し ま 
す。 

BASTOC は X- BASIC から C 言語への コンバータで すので、 初めに X - 
BASIC の プログラムを 作成し なければ なりません。 

また、 C 言語に 変換し やすいよ うな プログラムの 作成 方法が あります が、 本 
節では 開発の 流れを 中心に 説明し ますので、 X - BASIC の プログラムを 作成 
する うえでの 注总私 項は、 「5. 4 BASTOC での BASIC プログラムの; 1 ! •き 
かた j で说 明し ます。 

プログラム 間 発には、 大きく 分けて 次の 2 通 りが あります。 

⑴ X-BASIC で 独自に デバッグ 作業を 行い、 動作を 確かめてから、 完成し 
た プログラムを BASTOC を 使い C 首 語に 変換す る。 

(2) X - BASIC の プログラム ファイルを 直接、 CC コマンドに 指定して、 実行 
可能 ファイルを 作成して から デバッグ 作業を 行う。 



このような 2 通りの 方法が あります が、 通常は、 （1) の 方法を 採用して くださ 




XBAStoC BASIC プログラム 










第 5 章 XBAStoC BASIC プログラム コンバータ 



変換 方法 



BASTOC の コマンド 名は、 ” BC ” で ¥ BC の ディレクトリ 下にあります 0 
BC コマンドは CC コマンド M 様、 コマンド ラインに 入力し ます 0 



B > be bprog.bas @] 



1上 の 例は “ bprog . bas ’ •という X - BASIC の プログラムを BC コマンド ライ 
ン に衍定 した 例です。 

この場合、 出力は” bprog . c ” という C 这 語の ブロ グラムになります 0 
また、 ファイル 名に 拡張 をつ けても かまいませんが、 その 場合で も 出 カフ 
アイ ルは • C という 拡張す •になります 0 



mn コマンド ラインの 書式 



BC の コマンド ラインの ,1: ••式を 説明し ます 0 



be [く スイッチ〉 J ソースファイル 名 [く オブジェクト ファイル 名〉] 



ソースファイル 名 

ソースファイル 名の 指定は、 0 S に 依# します。 

「2.1.2 コマンド ラインの 指定」 を 参照して ください。 

なお、 CC コマンドで 変換す る垛 合は、 拡張 子を. bas あるいは . b にしな く 
ては なりません。 



才ブジ z ク卜 ファイル 名 

才 ブジェク 卜 ファイル 名は オプションです。 

才 ブジェク トフ アイ ル 名の 指定 もやは り、 os に 依存し ます。 

また、 オブジェクト ファイル 名は CON 、 PRN 、 AUX を 指定しても かまい 
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5.3 変換 方法 



ません。 

拡張 子は つけても つけなくても かまいませんが、 この BC の コマンドの 次の 
フェースが CC コマンド である ことから、 . c をつ ける のが一 般 的です。 

スイッチ 

スイッチの 指定 も オプションです。 

スイッチは、 BC コマンドを 実行す るう えで、 ユーザーに 変換 時の 模様 や 出 
カフ アイ ルへの コメント 行 （ BASIC 各行） の 神 入を 行います。 

次に 各 スイッチを 説明し ます。 
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「/ C く 行頭 TAB 数〉 ^ 

機 能 | オブジェクト ファイルに BASIC の 各行を C 言語の 注釈と して 出力し ます。 

< 行頭 TAB 数〉 を 指定す る ことにより、 注釈の 前の TAB の 数を 指定す る こと 
がで きます。 

く 行 頭 TAB 数〉 を« 略した 場 介は、 7 の TAB が 神人され ます。 



省 略] 注釈を 出力し ません。 
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I 



有1 BC の 変換の 様子を 色つ きで 標咿 出力に 表示し ます。 

リダイレクションを 指定した 場合は、 色が 表示され ません 
各 色は、 次の ような 总 味を もちます。 



小 伋 （強 



小 色 （反 紅) 



行 番号、 数値 
式、 記号 
未定 莪の もの 
变敉 、 FUNC 

I ) FF ファイル （. def > で定旄 している 文 や 関数 

BC が 内部 処理す る 文 や 関数 

注釈、 文字列 

エラー （丹 式の 炽り 等） 

# C 、 # ENI ) C で N ん であった 部分 



省 略 本 機能は 火 行 



/D bpro^.bas 












/E 



機 ^ 通常は、 エラーを コメント （/* 〜 */) の 型で ファイルに 出力し ますが、 この ス 

イッチで エラ一 行を 標準出力に 表示す るよう にします。 



省 略 標準出力に エラー 行を 表示し ません。 



例 



B>bc /E bprog.bas @] 
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r / H く ハッシュ バッファの 数〉 
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5.3 変換 方法 

CC コマンドでの 金換 



前に も 述べた ように、 BASTOC は CC コマンド でも 使用で きます。 

CC コマンドの ファイル 指定のと ころを、 BASIC ソース プログラムの ファ 
イル 名を 指定し ます 0 

なお、 この BASIC の ファイル 名の 指定に 聞して は、 必ず 拡張 f.bas ある 
いは . b をつ けなければ なりません。 

. bas あるいは . b をつ ける ことにより、 C コンパイラは、 指定され た 入 カフ 
ァイ ルが X-BASIC の ソース プログラム である ことを 認識して、 X-BASIC 
から C への 変換を 行います。 

また リンク 時に X-BASIC 固有の 関数を BASLIB . L に 探しに いきます 0 
X-BASIC IA 1 布の 丨对 数は、 次の 節で 紹介し ます。 

この C コンパイラで 変換す る 方法を 使丨丨 1 する ことにより、 ユーザーは、 い 
ちいち BC コマンドを 実行して から、 CC コマンドを 次: 行 するとい うよう 
な、 2 度の 手 1111 を 1 度で 済ませる ことができる わけです。 



B>cc bprog.bas @] 



CC コマンドの 変換を 行う 場合には、 BC コマンドの スイッチを 指定す る こ 
とはで きません。 



lui 巳 AST 〇 C のた めの C 言語 用 ライフ ラリ 関数 



BASTOC のた めの C mSJIl ライブラリ 丨对 数には 次の ような 関数が… 总 され 
ています。 

詳しい 内衫 について は 「 C ライブラリ マニュアル V 0 し 1」 を 参照して 〈だ 
さい。 
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BASTOC での BASIC プログラムの 害き かた 



本節では BASTOC を 使用す るう えで、 変換し やすい プログラムの 説明を し 
ます。 



Uai 綿の つけ かた 



BASTOC を利⑴ する 場合、 IW 数名 や サブルーチン 名な どのっ け かたに 制限 
があります。 

BASTOC で 変換す る 際に、 ある 说 則に 従って 変換す るた め、 使って はいけ 
ない 名前 や、 注意し なければ ならない 名前が あります。 

これを 無 祝した 場合、 コンパイル 時に エラーが 発生す る 可能性が あります。 

<1) 使って はいけ ない 名前 

① mam 

関数 名に” main” を 使用して はいけ ません。 

② s mm 

卵#### は 6 桁までの 半角 数字で、 この 名前は g 0Su b 文に 対応す る ラべ 
ル 名と して 使用され ます。 

③ l mm 

料#### は 6 桁までの 半角 数字で、 この 名前は goto 文に 対応す る ラベル 
名と して 使 用 されます。 

④ b 一?????？ 

“b_” で 始まる 名前は 使って はいけ ません。 

これは、 BASTOC が?????? の 部分を ある 規則に 従って、 BASIC で使っ 
ている 名前を そのまま 使用す るた めです。 

(2) 注意の 必要な 名前 

$ で 終わっ ている 名前が、 組み込み 関数 名 や システム 関数 名では ない 場合、 
BASTOC は 次の 規則に 従って 変換し ます。 

(3) 規則 

名前の 最後の *$’ を 大文字の* S’ に 置き換える。 




1 

bunSO 

1 



BASIC 

プログラム 



C 言語 

プログラム 



h 記の ような 規則に 従って 変換され るた め、 BASIC プログラムでは bun $ の 
荷 効範 叫で bunS を 使えません。 




式に ついての 注意 



演算 順序を はっきりさせる こと 

X - BASIC の 式を そのまま 変換した 場合、 一般的な 兗術 式の 範朔 内では 問題 
ありま せんが、 シフト 演兗 、ビット 滴算 、比較 演贫 、論理 演琢 が浞 在して い 
る 場合は、 演贫の 順序を 明確 (こする ために、 カッコを 使って 記述して くださ 
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5.4 BASTOC での BASIC プログラムの 害き かた 

dm 理) 等复 式に ついての 注意 コ 



(1) not の 使い方 

C 言語と X-BASIC では、 not の 後先 啪 位が 異なります。 

not を 使う 場 介は、 カツコを 使丨丨 j したり、 not の 有効 範叫 を 明確に 示す 必要 

があります。 

これを 無 祝した 場合、 結果が 違って きます。 



if not(a = 0) or b = 0 then x = 0 



(2) ビット 論理演算 

ビットごとの 論理 演兑 では、 and、 or、 xor が 使えます。 

(3> 酴理 演算の 価に ついて 

X-BASIC での 論理演算の 値は” ー1” か” 0” です が、 C 言語では” 1” か” 0” で 
す。 

この 値を 祕枨 的に 使った 場合 （数侦 として 用いた 場合)、 X-BASIC と XC で 
は プログラムの 勋 きが 変わる ことがあります。 

論理 侦の 判定には 0 ( 偽） か、 0 でない （rt> かで 行って ください。 



しては いけない こ と 



① endfunc の 後に main 部の プログラムを 絞け て:; 午 くことは いけません。 

② func で 宣言した 関数の 中から、 関数の 外に goto 文で 飛び出し てはいけ 
ません。 

③ func で 宣言した 関数を、 gosub 文で 呼び出し てはいけ ません。 

④ 次の 閲 数の 引数に、 文字列 定数を 指定して はいけ ません。 

strlwr 
strupr 
st r rev 

⑤ プログラムの 敁 後の endfunc 文の 後に、 注釈 文、 または 空文 以外の 文を 
齊 いては いけません。 
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B ASTOC の ファイル 構成 



本節では、 BASTOC を 使用す るた めの ファイル 構成に ついて 説明し ます。 
XC コンパイラの パッケージには、 この ファイル 構成に ついての 知識が なく 
て も、 すぐ BASTOC コマンドが 使 川で きる ように、 セッティングされ てい 
ますので、 初心者の かたは この 節を 説み 飛ばしても さしつかえありません。 




「BC 



ルート ディレクトリ 



この ディレクトリの 下には BASTOC の 本体で 
ある 突 行 可能 ファイル （ BC . X ) や、 変換に 必要 
な ファイルが あります。 

INCLUDE 



CC と BASTOC 共用の インクルード ファイル 
が 納められて います。 



mu 実行可能 ファイル 



BASTOC の 火 行" f 能フ アイノ レは、 BC ディレクトリの 下に ある BC . X だけ 
です 0 




CNF ファイルとは、 0 S 起勋 時の CONFIG . SYS のよう な ファイルです。 
X - BASIC は 拡張 型の BASIC で、 BASIC 本体に さまざまな 機能を 付加す 
る ことができます。 

通常、 この 機能は X - BASIC の 起動時に 決定され てぉり、 この 関数の 付加 
情報を 記述して あるの が、 BASIC . CNF です。 

BASIC . CNF は テキスト ファイルです ので、 エディタで 修正す る ことが で 
きます。 
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5.5 BASTOC の ファイル 構成 



DEF ファ ィル 



X - BASIC が もともと Ml 患して ある 関数、 midSO 、 sin 〇 や、 XXXXX.FNC 
として 後から 組み込む 関数、 a _ rec 〇 などは、 XC の 組み込み 関数では ありま 
せん。 

そこで、 C 言語 川に 押き 換える 必要が あります。 

そのための 指示が、 この DEF ファイルに 記述され ています。 

I ) EF ファイルは、 ft ライブラリ ごとに • DEF という 拡張 子を もった ファ イ 
ルと して、 BC ディレクトリの ドに 登鉍 されて います。 

次に fVDEF ファイルの 一な をボ します 0 

BASIC.DEF 

MUSIC 2 .DEF . 

SPRITE.DEF 

AUDIO.DEF 

MOUSE.DEF 

STICK.DEF 

GRAPH.DEF 

IMAGE.DEF 

(1)DEF ファイル 形式 

I ) EF ファイルの 形式は 次のように、 •‘：” で 区 切 られ ています。 

左側に X - BASIC の 開 数の 形式、 右側に 左側の 関数に 対応す る XC の 関数 
を紀述 します。 

X - BASIC の 関数 形式： XC の 問 数 形式 



例 



1 fread ( NA . I ， I ) 
F atof ( S ) 

S midS ( S . U ) 

1 msstat ( I , I , U ) 



b _ fread (%,@,%,%) 

(%) 

b _ midS ($, %,%,%) 

(&,&，&，&) 
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(2> BASIC 関数の 形式 

BASIC 関数の 紀述 形式を 説明し ます。 



< 関数の 型 >< 関数 名〉 （< 引数の 型 指定 並び >> 


鲁 関数の 型 •• 


•…型 記号を 用いて 型 指定し ます。 


♦型 指定 … 


"••下記に 示す 型 記号、 または、 それに“ 一” をつ けた もの。 




<5? 記号 > 1 <喟 記号〉 一 


♦型 記号 型 




C 


文字 型 


I 


整数 型 


F 


実数 型 


S 


文字列 型 


CA 


文字 型 配列 


IA 


整数 型 配列 


FA 


実数 型 配列 


NA 


数 切 fid 列 （文字 型、 核 数®、 実数® のい ずれで もよ い） 


SA 


文字列 型 配列 


♦関数 名 ••… 


•BASIC 1 用 数名 


籲 引数の 型 指定 並び …… 引数の 型が 上記の 型 記号で 示されて います。 


例 




F atof ( S ) 


I fread ( NA ， I ， I ) 


S mid $( S , U ) 


I msstat ( I ， I ， I ， I ) 
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5.5 BASTOC のフ アイノ レ 構成 



⑶ C 関数の 形式 
C 関数の 記述 形式を 説明し ます。 



[<閲 数名 >](< 引数の 指定 故び >) 



•関数 名 …… 対応す る C の 関数 名 

省略す ると X - BASIC の 関数 名と 同じ 名前が 使われます。 
♦引数の 指定 並び 

く 引数の 指定 > I < 引数の 指定 並び >< 引数の 指定〉 

♦引数の 彳} t 定 

引数の 指定とは、 たとえば、 a _/ ec ( NA , I > という BASICIW 数が、 XC では 
a _ rec ( buff , sizeof ( buff >, cl ) となる ように、 実 引数を 変換 するとき の 方法を 
指定す る ものです。 

引数の 指定には、 次の ような 記号が あります。 

# 領域の 人き さが 必要な 場合、 指定し ます。 

# は “ sizeof < l つ 前の 引数 >” として 変換され ます。 

1 つ 前の 実 引数は 単純 変数 か、 配列で なければ なりません。 

XC の 関数 側では 第 1 引数 以外で 指定して ください。 

@ 領域の 袈桌の 大きさが 必要な 場合、 指定し ます。 

@ は “sizeof ( 1 つ 前 の* j 丨 数 [0] > •’ として 変換され ます。 

1 つ 前の 実 引数は 配 列 か 文字 変数で なければ なりません。 

XC の 関数では 第 1 引数 以外で 指定して ください。 

& 実 引数の 変数の 内 答を 変える 場合、 指定し ます。 

実リ I 数の 変数の 内 V ? を 変える 場合、 XC では 引数の アドレスを 関数に わたさ 
なければ ならず、 引数に & 演算子を 付加し ます。 

また 、 X - BASIC の 実 引数は 単純 変数に なって いなければ なりません。 

$ $ は mid $(“ abC ”,2， l ) などの X - BASIC 特有の 文字列 関数を XC で 

実％ させる ときの み 用いる ための 指示です。 

strtmpO ， strtmpl , strtmp 9 を 実 引数と して 指定す る 場合、 必ず 

XC の 関数の 引数と して 指定し なければ なりません。 
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5.5 BASTOC の ファイル 構成 



% % は X - BASIC の 形式を そのまま 変換し ます。 

例 



(%) 

b_fread(%, #,%,%) 

(&，&，&，&) 



※中 •純 変数とは 

中 •純 変数とは、 rtd 列 変数では ない 変数の ことを いいます。 

① DIM で 宣言して いない 変数 （ 単 純 変数） 

② STR で宣宮 している 変数が 文字列 変数 （中 純 変数} 

③ DIM STR で 宣言して いる 変数が 文字列 配列 （配列) 



QQ 3 インクルード ファイル 



インクルード ファイルは XC コンパイラと 共用す るた め、 「1. 2. 2 ⑵ 
INCLUDE 」 の 中に 含まれて います。 

BASTOC の インクルード フ アイノ レは 次の 通りです 0 

AUDIO.H 

BASIC.H 

BASIC 0 .H 

GRAPH. H 

IMAGE.H 

MOUSE .!! 

MUSIC.H 

MUSIC 2 .H 

SPRITE.H 

STICK.H 
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5.5 BASTOC の ファイル 構成 



外部 関数 



ユーザーが 独自に 作成した 外部 関数を 使用した プログラムは、 単に BAS - 
TOC を 使 1丨丨 する だけでは 実行可能 ファイルに する ことは できません。 
ここでは 、ユーザーが 作成した 外部 関数を 実行可能 ファイルに する ための 手 
順につ いて 説明し ます。 

① X — BASIC で 完全に 觔作 する BASIC の ソース プログラムを 作成す る 0 

② 外部 関数に 対応した、 DEF ファイルを 作成す る。 

I ) EF ファイルの W 造に ついては、 「5.5.4 DEF ファイル j を 参照して 
ください。 

新しく ファイルを 作成しても、 すでに ある DEF ファイルに 付け加えて 
も かまいません。 

ただし、 DEF ファイルは BC . X と M じ ディレクトリ にある 必要が あり 
ます。 

③ 外部 関数に 対応す る C の ラィブラリを 作成す る。 

具体 (ド りには、 外部 間数の ソース プログラム （アセンブリ） から 閲数 琳 位 
で 次: 行 部分を 抜き出し、 C 言語との インターフェース 部分を 付け加え ま 
す。 

詳しくは 、「第 4 取 アセンブラとの インターフェース j を 参照して く 
ださい。 

また、 新しく C 言語を 使 川して M 機能の 関数を 作成しても かまい ませ 
ん 0 

_ で 作成した プログラムを アセンブル する。 

このと き リンクす る 必要は な 〈、オブジェクト ファイル （• 0) のま ま 
でかまい ません。 

⑤ BASLIB . L に 登録す る。 

④で 作成した オブジェクト ファイル （• 0) を LIB . X を 使用して、 
BASLIB . L に 登録し ます。 

使) H 頻度の 低い 関数は ライブラリ として 登録す る 必要はありません。 
ただし、 そのと きは リンクす るた め ファイル 名を 指定し なければ なり ま 
せん。 

また、 既存の ライブラリに 登録 するとき は、 同じ 名前の ファイルがない 
かを 確認して ください。 

ライブラリの 登録 ファイル 名は LIB . X の / L スイッチで 知る ことが で 
きます。 
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5.5 BASTOC のフ アイノ レ 構成 



⑥ インクルード ファイルで 関数 宣言を する。 

新しく 作成した 外部 関数の ライブラリを 利用す るた め、 インクルード フ 
ァイ ル （ BASIC . H か BASICO . H ) 内で 関数 宣言を 行います 0 
聞 数 宣言に ついては 「 C リファレンス マニュアル j の 「3. 2 閲数 j を 
参照して ください。 

閲数 宣言は、 C の ソース プログラム 内でして も かまいません 0 
また、 別の インクルード ファイルで 宣 a をしても かまいません 0 
しかし、 それには C の ソース プログラムを 开 き 換えなければ ならいの 
で、 CC . X を 使用して 一度に 戈 行 可能 ファイルを 作成す る ことは できな 
〈なります。 

⑦ コンパイル する。 

CC . X を 使 川して コンパイル します （• BAS — • X ) 〇 
あらかじめ、 BC . X を使⑴ して C の ソース プログラムを 作成して から 
コンパイルしても かまいませんが 、コンパイル 時に BASLIB . L を リン 
ク させる ため CC . X の / W スイッチを 指定して 〈ださい。 

⑤で ライブラリ ファイルに® 鉍 していない 場 介は 次のように、 コマンド 
ラインで リンクす る ファイル 名を 指定して ください。 

A>CC SAMPLE . BAS SAMPLE 1 . O 



⑧完成 

まとめる と、 DEF ファイル、 インクルード ファイル、 ライブラリの 3 
つを 丨 1丨 立し、 CC . X を 使用す る だけで、 外部 関数を 用いた BASIC プロ 
グラムを 灾行 可能 ファイルに する ことができます 0 

そのうち、 DEF ファイルと インクルード ファイルは、 関数 lflfl あたり 
1 行の 宣言を 行う だけです。 

ライブラリ も X - BASIC との やりとりを する インフォメーション テ一 
ブル や、 トークン テーブル などの インターフェース 部を、 C 言語との イ 
ン ターフェ ース 部に 策き 抒 える だけで よいので、 比較的 簡単に 移植す る 
ことができます。 
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追加 BASIC 関数 



追加 関数 リファレンス 
MIDI 拡張 MML 
サンプル プログラム 



X 68000 では MIDI ボードを 次: 装す る ことで、 MIDI インターフェイスが 装 
備 されて いる iti 版の 楽器を 制御で き、 内蔵 音源を 越えた すばらしい 演务 が " r 
能になります 0 

XC コンパイラは、“ 0 PMDKV 2. X ” （ デバイス ドライバ） や“ MUSIC 2. 
FNC ” （インクルード ファイル） を 組み込む ことで、 MIDI ボードの 治丨1 御が 
" f 能になります。 

本饮 では、 これにと も なって 追加され た BASIC の 命令 リファレンスと、 拡 
吸され た MML について 说 叫し ます。 

これにより、 BASIC で MIDI を 使った 演务 が" f 能に なり、 BASIC プ ログ 
ラム コンバータを ⑴ いる ことで、 Cg 雄で も演赛 が 可能になります。 

また、 サンプル プログラム も 伏 木に 掲舣 してあります 0 




第 6 章 追加 BASIC 関数 



追加 関数 リファレンス 




害 式 | MD CONT ( n ) 



MUSIC 






機 能 指定した チャンネルの FM { V 源、 および MIDI の潢务 を 冉開 します。 

この 命令は 、 MD STOP で一 時屮 断した 演奏を 冉開 するとき に 使います。 
n を« 略す ると、 すべての チャンネルの 演 赛を洱 開し ます。 



0 〜 7 ビット ： FM fi : 淞の 1 〜 8 チヤン ネル 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビットを 1 にした チヤン ネルを 爯 開す る 



炭り Wi として、 正？?; のとき は 0、 エラーの ときは 一 1 を 返します。 





MD INIT () 



MUSIC 




MIDI ボードの 初期化を します。 

M ASSIGN で劄り あてた 卜 ラックは 、 MD INIT で 初期化して ください。 



また 、 M ASSIGN で 別り あてる 9 〜 24 チヤン ネルは、 それぞれ デフ オルトで 



81 〜 96 トラックに 対応して います。 
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MD _ OFF 

害 式 | MD OFF ( n ) 



MUSIC 



引 


数 




戻 


り 値 




機 

- ■ — 


m 



指定した MIDI の チヤン ネルの 出力を f ? •止します 0 
n を VT 略す ると、 全 チヤン ネルの 出力を ff •止します。 

W り fift として、 止??; のとき は 0、 エラ一 のとき は 一 1 を 返します。 



0 〜 7 ビット ： 常に 0 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビット 1 にした チヤン ネルの 出力を 停止す る 
24 〜 31 ビット ： 常に 0 



MD_ON 



害 


式 




引 


数 




戻 り 


値 




機 





MI ) ON ( n ) 



指定した MIDI の チャンネルの 出力を 開始し ます。 
n を 省略す ると、 全 チャンネルの 出力を 開始し ます。 

戻り 値と して、 正常のと きは 0、 エラーの ときは 一 1 を 返します。 



MUSIC 



0 〜 7 ビット ： 常に 0 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビット 1 にした チヤン ネルの 出力を 開始す る 
24 〜 31 ビット： 常に 0 
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第 6 章 追加 BASIC 関数 



MD _ PLAY 



MUSIC 



害 


式； 




引 


数 




戻 1 


J 値 




機 





MD PLAY ( n ) 



指定した チャンネルの FM •源、 および MIDI の演赛 を 開始し ます 0 
n を朽 略す ると、 すべての チャンネルの 演赛を 開始し ます 0 



0 〜 7 ビット ： FMff 源の 1 〜 8 チヤン ネル 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビットを 1 にした チヤン ネルを 演赛 する 



W •り 矾 として、 正常のと きは 0、 エラーの ときは 一 1 を 返します。 



MD _ REGR 



MUSIC 



* 


式 




引 


数 




戻 


り 値 




機 


有 巨 



MD REGR ( n . m ) 



char 



MIDI 制 街丨 IC ( YM 3802) の レジスタを 読み込みます。 
n に グループ ナンバー、 m には レジスタ ナンバーを 指定し ます。 

戻り 侦 として、 正常のと きは 0、 エラーの ときは 一 1 を 返します。 

注： 問 途った パラメータを 指定す ると、 システムが 正常に f 力作 しなくなる 場合が 



あります。 



YM 3802 の 機能を 十分に 理解の 上で ご 使用く ださい。 
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MUSIC 



MD _ REGW 

害 式 ] MD REGW ( n , m , dt ) 

引 数丨 char 

戻り 値 int 

機 能 j MIDI 制御 IC ( YM 3802) の レジスタに 値を 杏き 込みます。 

n に グループ ナンバー、 m には レジスタ ナンバーを 指定し ます。 
dt には レジスタに iH ••き 込む 攸 を、 0 〜 255 の範 州で 指定し ます 0 
戾り W (として、 正常のと きは 0、 エラーの ときは 一 1 を 返します。 

注 • ： II ! 丨 4 つた パラメータを 指定す ると、 システムが 正常に 動作し な 〈なる 場合が 
あります。 

YM 3802 の 機能を 十分に 理解の 上で ご 使 川く ださい。 
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第 6 章 追加 BASIC 関数 




STAT 



MUSIC 



害 


式 




引 


数 




戻 1 


J 値 




機 


fig 



MD_STAT ( ch ) 



ch で 指定した MIDI の チヤン ネルへ、 データが 出力で きる かどう かを 凋べ ます 0 
ch には、 状態を 調べたい チャンネルを 9 〜 24 で 指定し ます 0 
ch を 朽 略す ると、 すべての チヤン ネルの 状態を 凋べ ます 0 



• ch が 9 〜 24 のとき 
0 : 出力 停止 
1 : 出力 可能 

• ch を 竹 略した とき 

0 〜 7 ビット ： 常に 0 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビットが 0 で 出力 伶 止、 1 で 出力 可能 
24 〜 31 ビット ： 常に 0 



どちらの 場合 も エラーの ときは、 一 1 を 戻り 値と して 返します。 

MDSTAT は演务 中 かどう かを 調べる ものではありません。 これにつ いては M 
STAT を 参照して 〈ださい。 
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MD 一 STOP 



MUSIC 



害 


式 




引 


数 




戻 


り 値 




機 


有 g 



MD STOP ( n ) 



指定した チヤン ネルの FM 音源、 および MIDI の演# を 一時 中断し ます。 
n を 朽 略す ると、 すべての チヤン ネルの 演奂を 一時 中断を します。 



0 〜 7 ビット ： FM 荇 源の 1 〜 8 チャンネル 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビットを 1 にした チヤン ネルを 一時 中断す る 



« •り M として、 正常のと きは 0、 エラーの ときは一 1 を 返します。 




WRT 



MUSIC 



[«L 


式 


MD WRT ( n ) 


区 


数 


char 




り 値 


int 


「機 


m 


MIDI ボードに n を 出力し ます。 
戻り 値と して、 正常のと きは 0、 
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第 6 章 追加 BASIC 関数 




MUSIC 



害 


式 




引 


数 




戻 


り 値 




機 


能 



M STAT ( ch ) 



char 



指定され た チャンネルが 、滴# 中 かどう かを 凋べ ます。 

ch には、 凋べ たい チヤン ネルを 1 〜 24 で 指定し ます 0 

ch を W 略す ると、 すべての チャンネルの 演务 状態を 返します 0 



• ch が 1 〜 24 のとき 
0 : 停止 中 
1 : 演奏 中 



• ch をれ 略した とき 

0 〜 7 ビット ： FM 音 •源の 1 〜 8 チヤン ネル 
8 〜 23 ビット ： MIDI の 9 〜 24 チヤン ネル 

ビットが 0 で 停止 中、 1 で 演奏 中 
24 〜 31 ビット ： 常に 0 



どちらの 場合 も エラーの ときは、 一 1 を戾り 侦 として 返します。 
なお、 この 命令は 從 米の M STAT の 機能を 拡張した ものです。 
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MIDI 拡張 MML 



MIDI 制御の ために 拡張に なった MML は、 次の 通りです。 
MIDI 拡張 MML — 览 



MML データ 


意 味 


パラメータ 範囲 


’< アポ スト ロ 
フィ一) 


MIDI 拡张 MML の 使 ffl を 開始/ 
終了す る 




Tn 


MIDI 送信 チヤン ネル セット 


1 〜 16 


Pn 


r 

MIDI プログラム チェンジ 


卜 128 


On , m 


ノート 才ン 


0 〜 127 


Fn 


ノート 才フ 


0 〜 127 


$n 


ダイレク 卜 送信 データ 


0 〜 255 


n 


ダイレク 卜 送信 データ 


0 〜 255 



MIDI のべ ロシイ テイ （迕说〉 は、 MML の V で だいたいの 凋 節を 、 @V 
で微綢 整を 行います。 

なお、 デフ オル 卜では V = 8 、 @V = 80 に 設定され ています。 

MIDI 拡張 MML を 使 ⑴ する 場合には、 MIDI 拡張 MML の 先頭と 末; 名 
を ’ で 1«1 まなくて はなり ません。 

例 0* nTc 4 d 8 e 8 f 8 g 8 a 4 

また、 MIDI 拡張 MML を述 絞して ゼ述 する 場合は、 ft MML データを*,’ 
で K 切って 〈ださい。 

例 o 4， Tl , P 123, F 40’ c 4 d 8 e 8 a 4 

これら 以外に 次の 3 点 も 拡張され ています。 

•演奏 中に CTRL+D を 押す と、 演奏を 停止し ます。 

•卜 ラック ナンバーの Ai •大侦 は 223 に增設 されて います （従 米は 80)。 

• MIDI クロックは 常に 出力され ています ので、 外部の MIDI 音源との 同期 
が 可能です。 
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/* 

/ * music sample 

/* •• おお、 スザンナ ！！” S.C.Foster 

/* 

str tr,as ， bs,cs ， ds ， partl255 】 

m_ini t ( ) 

md_ini t ( ) 

m_alloc( 10 , 2000 ) 

m_as3ign( 10 f 10 ) 

llnput ”M I D I 送 馆 チャンネル （ 1 〜 1 6 > >?";tr 

1 input ” ブロ グラム ナンバーを 入力して 下さい （ 1 〜 1 2 8 > >? ”； as 

1 input ” テンポを 入力して 下さい （ 3 2 〜 2 0 0 > > ? ";bs 




part=” ， T”+tr+”,P”+as+”，"+” 〇 4 v9 q7 116”+” t”+bs 
wr_ t rk ( part } 

part= M g&a b8<d8d8e8> <d8>b8g8 . a b8b8a8g8 a4 • ga&” 
wr_trk < part ) 

part= "b8 く d8d8 • e> <d8> b8g8 . a& b8b8a8a8 g4 • ga&.. 
wr_t rk ( part ) 

part= M b8<d8d8 . e> <d8> b8g8 • a b8b8a8g8 a4r8ga&" 
wr_trk ( part ) 

part= M b8<d8d8e8> <d8 . >bg8 .a bb8.a8.a g4r4 t# 
wr^trk ( part ) 

part = M <c4c4> <e8e4e8> <d8 .d>b8g8 a4r8ga& #t 
wr— trk ( part } 

part = M b8<d8d8 • e> <d8>b8g8a8 b8b8a8 .a g4r8 #, 
wr_t rk ( part ) 
md play ( ) 

linput ”*赛 を 停止し ます かく y/n > >? ”； cs 

if cs= n. then end 
md_stop( } 

linput ” 演奏を 再開し ます かく y /n > > ? ”； ds 

if ds= M y f, then md__cont ( ) 
end 

func wr^trk ( part ; str ) 
m_trk( 10 f part ) 
endf unc 



0000000000000000000000000000000000000 
1234 5 678901234 5 6789012345678901234567 

1111111111222222222233333333 
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がで きます。 

コードは 1 文字です。 




▲丨 明 1 貢，^ 



記号 


コード 

(16 進) 


機 能 


BEL 


07 


bound bell 
ベルを 喵らす 

ベルの fV •は、 CONFIG . SYS ファイルの 中の“ BELL = < フ ァイ ル 
名〉” の 記述に 従う 


BS 


08 


cursor backward 
カーソルを 1 文字 左に 移動す る 

カーソルが 行の 1 カラム 丨』 にある ときは 1 行 上の M 終 カラムに 移勋す 
る 

カーソルが ホーム ポジション （1 カラム U 、 1 行丨 ：0 にある ときは 無効 


HT 


09 


bkip to next tab stop 
カーソルを 次の タブ 位 K に 移 $ 力 する 

タブの 位; K は、 キャラクタ 座標の ム i 人力 ラム 数を 超えない 8 の 倍数 
で、 次のように 決められる。 

08、 16 …… キャラクタ 座標の W 大力 ラム 数より 小さい 8 の 倍数の ム i 

大侦 ( J 丨 i 大の タブ 位 策） 

カーソルが 砧 人の タブ 位; K の カラムよりも ギ丨 •側に あるときは 1 行 下の 
1 カラム H に移觔 する 

カーソルが W 終 行に あるときは 1 行 スクロール アップす る 


LF 


0 A 


cursor down 

| nl じ カラム 位 策で カーソルを 1 行 下に 移!! 力す る 
カーソルが 敁 終 行に あるときは 1 行 スクロール アップす る 


VT 


0 B 


cursor up 

同じ カラム 位; S で カーソルを 1 行 上に 移觔 する 
カーソルが _而 の 1 行 目にある ときは 無効 













記号 



CR OD 



Cursor iorward 

カーソルを 1 文字 右に 移！ f 力す る 

カーソルが 行の iii 終 カラムに あるときは 1 行 下の 1 カラム hi に 移 $ 力す 
る 

カーソルが 丨丨 1/ 丨而砧 終け のム i 終 カラムに あるときは 1 行 スクロール アツ 
プ する 



ニ 移勋す 



Clear screen 



_而 の 衣 示を すべて クリアす る 

その後、 カーソルは ホーム ポジションに 移勋 する 



I ESC sequence 
一 ドの 始まり 

こ 絞く 文字に より、 エスケープ シーケンス による 丨山 •丨丨 fti 制 



KS 



Cursor HOME 

カー ゾ ルを ホーム ポジションに 移! PJj する 







■キャラクタ コード 表 

次の 表は、 1 バイトコード （半角 文字） の 一％ です。 

i バイトコード 文字には 、キャラクタ コードの 〇 〜 255(16 進 法で 〇x〇〇 〜 〇xFF) が 割り あ 
てられて います。 

キャ ラク タコー ドに 割り あてられ ている 文字には、 閣形 文字と 制御 文字が あります。 

W 形 文字は、 _而 上の 表示 や プリンタの 印刷の ための 文字で あり、 制御 文字は 画面の 制御 
と プリンタの 制御の ための 文字です。 

プリンタ に対する 制御 文字の 動きに ついては、 各 プリンタの 取扱 説明 宵を 参照して くださ 

い 0 

また、 0 x 80 〜 0 x 9 F 、 OxEO 〜 OxFF までは、 漢字な どの 2 バイ 卜 コード 文字の 1 バイト 目 
として 使用され ます。 

上位 4 ビット— 

下 
位 
4 
ビ 




ンハ °イ ルス イッチ 一 



背告 レベルの 指定 

C a 語 ソースファイル （. c > のみの 作成 
コメント 行の 保存 
マクロ 定義 

識別子の W 人 •敁の 指定 
リンクの 抑制 

アセンブラ ソースファイル （. s ) の 出力 ファイル 名の 指定 
才 ブジェク 卜 ファイル （.〇> の 出力 ファイル 名の 指定 
アセンブラ ソースファイル （. s > のみの 作成 
文 行 可能 ファイル （. x > の 出力 ファイル 名の 指定 
シンボルの 砧人彳 W 数の 指定 （パーザ 部） 

シンボルの 讪 人 数の 指定 （ AS 部〉 

ハッシュ バッファの Ai 大 個数の 指定 （ BC 部） 

スタック 検赍の 指定 
ヒープ サイズの 設定 

シンボルの 敁大個 数の 指定 （プリプロセッサ 部） 

スタック サイズの 設定 

インクルード パスの 指定 

char ¥! を unsigned char とする 

32 K バイ 卜 以上の auto 変数の 使用許可 

浮 I 力 小数点 演讶 ライブラリの 変史 

ライブラリ パスの 指定 

ソースコード デバッガ （ SCD . X ) Ifj コードの 屯 成の 指定 

プログラムの 讪 適 化 

プリプロセッサの 出力を ファイルへ 出力 

同一 コード 文字列の 丨 土: 縮 

作業 パスの 指定 

マクロ 定義の 取り消し 

プリプロセッサの 出力を 標準出力へ 出力 

BASIC ライブラリの 使 川 フラグ 

定義 済み 淼別イ •_ _ STDC _ _ を 未定義 

DOS / IOCS ライブラリの 使用 フ ラブ 
























4 




CTRL C Terminated 




エラー メ 


ッ セージ 


意 味 


CC ドライ 

- 


パの エラー 



CTRL + C または アボートで 中断され ま 



Cant find ( 次 : 行フ アイノ レ） 



CC driver error : No enough memory 
Fatal Error in (エラー 泝 引 



起 $カ しようと した 実行 ファイルが 兄つ か 
りません。 

メモリが 足りません。 

エラーが 発生し ました。 エラ 一浪 号は 
errno がポす エラー } & 号です 0 




illegal option string ( 乂， : 列 ） is ignore 



illegal file name ( ファイル 名 ） is ignore 
C し driver warning : option duplicate l“J 

CC driver warning : illegal option 

CC driver warning : illegal option used 




スイッチです 。無 祝し 



名です。 無视 しました。 
スイッチを 2 丨 丨丨 丨以ト .指定 



ン スイッチが 指定 されて 



ッ チの 使 川 方法が 不正で 



XBAStoC 




source nle not found 


指定の 入力 ファイルが 兄つ かりません 0 


source i lie open error 


指定の 入力 ファイルが オープンで きませ 




ん 0 


source file reaa error 


指定の 入力 ファイルから 入力で きませ 




ん 。 


destination nle write error 


指定の 出力 ファイルに 出力で きません 0 


no enough memory 


メモリが 足りません。 


symbol table overflow 


シンボル 悄 報が あふれました。 


#endc less 


#endc がありません。 


illegal statement number 


行 番号に 誤りが あります。 


syntax error 


構文に 誤りが あります。 


FOR-NEXT initialize error 


for 文の 初期値 設定に 誤りが あります 0 













エラーメッセージ 

illegal GOTO/GOSUB 
too few parameters in call 
illegal data type 

statement without main program 
statement without function 
nothing THEN of IF statement 
nothing format string of USING state- 
ment 

nothing semicolon of USING state- 
ment 

illegal SWITCH-ENDSIWTCH state- 
ment 

illegal REPEAT-UNTILL statement 

illegal WHILE-ENDWHILE state- 
ment 

illegal FOR-NEXT statement 

illegal FUNC-ENDFUNC statement 

{ } error 
illegal data in { } 
nothing function name 



意 味 

goto 文， gosub 文に 誤りが あります。 
引数の 数が 違います。 

データの 型が 違います。 

end 文 以降に 無効な 文が あります 0 

endfunc 文 以降に 無効な 文が あります 0 

if 文の then がありません。 

using 文の 杏 式 制御 文字列が ありませ 

ん 0 

using 文の 害 式 制御 文字列の 次に 丫があ 
りません。 

swich 文と endswitch 文の 対応に 誤りが 
あります。 

repeat 文と untill 文の 対応に 热 りが あ 
ります。 

while 文と endwhile 文の 対 必に游 りが 
あります。 

for 文と next 文の 対応に 誤りが ありま 
す。 

func 文と endfunc 文の 対 J 芯に 誤りが あ 
ります。 

{ と } の 対応に 誤りが あります 0 
{•••} の 中の データに 誤りが あります。 
func 文に 関数の 名前が ありません。 



0 error 

undenned statement number 

illegal statement numoer in uOTO/ 
GOSUB 

function name duplicate 
BC stack overflow 



( と） の 対応に 誤りが あります。 
goto 文， gosub 文で 指定した 行 番号が 
ありません。 

goto 文， gosub 文で 指定した 行 番号が 
無効です。 

関数の 名前は 既に 定義され ています。 
式が 複雑す ぎて 評価で きません。 





ッ セージ 



プリプロセッサの エラー 



(マクロ 名 > : recursively macro 
(マクロ 名 ）： actuals too long 

token too long 

マクロ 名 ： unterminated macro call 

too many dennes 

マクロ 名 ： too much pushback 

no space 

bad include syntax 
Unreasonable include nesting 
Unreasonable if nesting 

cpp internal error : No Space 

Can’t find include file フ アイノ レ 名： パス 
名 

too much defining 
マクロ 名： missing ) 
bad formal : ¥ 

too much formals : 仮 引数 名 

operator undenned 1 paramater 

# operator should be 10110 wed by a 
macro argument name 
## operator undefined 2 paramater 

too many/D options， ignoring 引数 



マクロ 名は 再帰 呼び出しされ ています。 
関数 W マクロの 定義で、 実 引数が 技す ぎ 
ます。 

トークンが 長す ぎます。 

マクロ 呼び出しが 完結して いません。 
マクロ 定莪の 数が 多すぎます。 

マクロの ネストが 妯 高値 （14 個） を 越 
えました。 

メモリに 空きが ありません。 

# include 文の 文法が 逢います。 

# include 文の ネストが 深す ぎます 0 

# if , # ifdef . # ifndef 文の ネストが 深す 
ぎます。 

プリプロセッサの 内部 エラーです。 メモ 
リに 空きが ありません。 

指定され た インクルード ファイルが、 パ 
ス 名の ディレクトリに 兄つ かりません 0 
マクロの 定義 内斿が 大きす ぎます。 

| 対数 5! マクロの 定 箱で、〉 が 足りません。 
聞 数 型 マクロの 定義で、 定義 内綷 以外の 
部分に 対して 行の 継 絞を 行って います。 
関数 5? マクロの 定義で、 仮 引数の 個数が 
多すぎます。 

## の 左辺の パラメータが 定莪 されて いま 
せん。 

マクロの 仮 引数と# の パラメータ がー 
致して いません。 

## の 右辺の パラメータが 定義され てい ま 
せん。 

/ D オプションが 20 個を 超えました。 引 
数を 無 祝し ました。 







too many/U options, ignoring 引数 




エラーメッセージ 


意 味 


too many/U options, ignoring 引数 


/U オプションが 2(HW を 超えました 。引 
数を 無 祝し ました。 


excessive バ file (パス 名〉 ignored 


/I オプションが 8 を 超えました 。ノ ぐ 
ス 名を 無视 しました 0 


No source file ファイル 名 


ソースファイルが ありません 0 


Can’t create フ アイノ レ 名 


作龙 J 11 ファイルが 作成で きません 0 


# endif less 


#endjf 文に 対応す る# if がありません。 


# else less 


# else 文に 対応す る# if がありません。 


undefined control 


プリプロセッサ 命令 以外の 未定義な# で 
始まる 文が あります。 


# line Illegal line no 


# line 文に 指定した 行 S 号が 不正です。 


# line Illegal file name 


# line 文に 指定した ファイル 名が 不正で 

十 


Illegal character 文？： in preprocessor # 


1 〇 

#if 文、# elif 文の 式 中に 不正な 文字が 


if 


あります。 


Illegal number 文字列 


文字列は 数字と して 評価で きない 不正な 
文字列です。 


yacc stack overflow 


式が 複雑す ぎて 評価で きません。 


syntax error 


式 評価の エラー、 または プリプロセッサ 
命令の 文法 エラーです。 


プリプロセッサの ワーニング 


(マクロ 名）： argument overflow 


マクロの 仮 引数の 数が 多すぎます。 


(マクロ 名）： argument mismatch 


マクロの 仮 引数の 数が あってい ません。 


Illegal macro name 


マクロ 名に 不正な 文字を 使用して います。 


マクロ 名 redefined 


[ SJ —の マクロ 名で、 異なる 内容を 定義し 
なおして います。 


パーザの 致命的 エラー 


identifier overflow 


淼別 子が 多すぎます。 


symbol table over 


シンボル 情報が あふれました。 


no enough memory 


メモリが 足りません。 


expr stack overflow 


式が 複雑す ぎて 評価で きません。 









4 •エラーメッセージ 一 賢 



エラーメッセージ 


意 味 


imdc file error 


作業用 ファイルの 作成に 失敗し ました。 


reach EOF 


()、 り、’…、/**/ などが 閉じて ぃま 
せん。 ファイルの 終わりに 達しました 0 


source file not found 


ソースファイルが 兄つ かりません。 


temporary file create error 


作業 用 ファイルが 作成で きません 0 


パーザの エラー 


Unknown character 


不正な 文字が 存在し ます。 


illegal preprocessor # line 


プリプロセッサで 処理され なかった# 命 
令が 残って います。 


comment statement error 


注釈 文の 热 りです。 


string error 


文字列が m じていません。 


undefined identifiter in function name: 


聞 数 内で 未定義の 淼別 子が 使⑴ されて い 


嫌 別 子 


ます。 


number syntax error 


数侦 定数で 許されない 数字を 使 w してい 
ます。 


expression error 


式 評価の 淇 りです。 


storage class illegal : 丨记饱 クラス 指定 


記惊 クラスの 指定が 不正です 0 


亍 

too many } 


} が 多すぎます。 


external dennition error 


外部 参照 宣言の 誤りです。 


illegal use of storage class ： arg. 


引数の 宣言に おいて 記惊 クラスの 指定が 
不正です。 


illegal use of storage class ： proto type 


引数の プロトタイプ 宣言に おいて 記憶 ク 


arg. 


ラスの 指定が 不正です 0 


illegal use of storage class: iS 己 惊 クラ 
ス 指定 子 


記 惊 クラス 指定 子の 使用法が 不正です。 


illegal use of indirect : 蔬別子 


式 中の 間接演 穿 子の 使い方の 誤りです。 


identifier duplicate : 雜別子 


識別子が 重複して います。 


intermediate cade error 


中間 コードの 誤りです。 


undefined struct/union name 


構造体/共用 体の 名前が 未定義です。 


illegal type specifier 


不正が 型 指定 子が 指定され ています。 


no assign array element 


配列の 添字 数が ありません。 


too many initializer 


初期化 要素が 多すぎます。 



160 






enum constant error 
declaration error 
missing] 

missing) in declarator 
missing) in function declaration 
function declaration error 
{ > error in struct/uion 

overflow type specifier 

identifier redeclaration 
struct/untion/enum tag name error ： 
タグ 名 

storage class error at function 

struct member overflow 

break error 

continue error 

cast type error 

difference typedef name 

field width overflow 

fiele type error 

array dimension overflow 

element index mdssing 

undefined identifier 

function argument error : 蔬別 子 

( missing 

) missing 

> missing 

statement error 

case statement error 

default statement error 



列挙 型の 定数の 誤りです。 

宣言の 誤りです。 

] が 足りません。 

宣言に おいて） が 足りません。 

関数 宣言に おいて） が 足りません。 

関数 宣言の 誤りです。 

構造体 / 共用 体で { と} が 合って いませ 
ん 0 

切 指定 子が 複雑す ぎて、 オーバーフロー 
しました。 

淼別 子が 洱 宣言され ています。 
構造体 / 共用 体 / 列挙 型の タグ 名 （名札 ) 
が 誤りです。 

関数の 妃愤 クラス 指定が 誤りです 0 
構造体の メンバ 要 索が あふれました 0 
break 文の 誤りです。 
continue 文の 热り です。 

型変換に おいて 型 指定 子が 热 りです。 
typedef で 指定した 名前が、 式 中に 不正 
な 使われ かたを しています。 

ビット フィールドの ビット 数が あふれ ま 
した。 

1 ビット フィールドの ビット 幅が、 敁高 
値を 越えました。 

配列の 次元 数が あふれました。 

配列の 要 索 数が 指定され ていません。 
溆別 子が 未定義です。 

識別子は 関数への 引数ではありません。 
( が 足りません。 

) が 足りません。 

} が 足りません。 

構文の 誤りです。 
case 文の 誤りです 0 
default 文の 誤りです。 





4 •エラーメッセージ 一覧 



エラーメッセージ 


意 味 


switch table overflow 


switch 文の case の 数が あふれました 0 


more than 1 default 


default 文が 2 つ 以上あります 0 


ii else statement error 


if 文と else 文が 正しく 対応して いません 0 


keyword error : 予約語 


予約語の 丨丨丨 法の 誤りです。 


undenned struct/union used 


未定義の 構造体/共 丨丨丨 体が 使丨丨 1 されて い 
ます。 


struct/untion initalizer over 


構造体/共 丨 H 体の 初期化 要桌が 多すぎ ま 
す。 


compound statement error 


問 数 定義 後の ブロック 文の 热 りです。 


constant expression pequired 


定義 式で なければ いけません。 


division by zero 


0 で除兑 しました。 


left value required 


左辺 値で なければ いけません。 


operand type mismatch 


潢苋 数の 型が 興なります。 


type conversion error 


切 変換が 不可能です。 


type conversion illegal 


5? 変換が 不正です。 


thrinary operator error 


三項演 飫 f の热 りです。 


non-function call 


1 对数 以外を 呼び出して います。 


no left value 


アドレス 演兗 子の 誤りです 0 


struct reference error 


構造体 参照の 誤りです。 


do not same operand size pointer 


iiiT 京 子の 大きさが 合って いません。 


void function 


戻り 侦 無し 関数な ので 戻り 値は 指定で き 
ません。 


void type error in expresstion 


式の 中に 値を 持たない 項が あります 0 


structure declaration error 


構造体 宣言の 誤りです。 


argument duplicate definition 


引数の 宣言と プロトタイプ 宣言が® 複し 
ています。 


illegal use of floating point 


浮！ SJJ 小数点 値は 使 川で きません。 


illegal initiarise error : 蕊別 子 


淼別 子は 初期化で きません。 


too few parameters in call 


関数 呼び出しで 引数の 個数が あってい ま 
せん。 


auto variable 32Kbytes over 


自勋 記惊 指定 子の 変数が 32 キロバイト 
を 超えて います。 
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エラーメッセージ 


意 味 


structure size 32Kbytes over 
two consecutive dots 


稱造体 変数が cb キロバイトを 超えて い 
ます。 

聞 数 プロトタイプ 戌言 で 不定 fl 句 パラメ 一 
タの 宣言が 誤りです。 


パーザの ワーニング 


■ 

character constant overflow 


文卞 定数が 衣 祝 ” f 能な 紐 N を 超えて いま 

十 


undefined identifier 
void type declarator 
type specifier illeagal 
short type specifier illegal 
unsigned type specifier illegal 
long type specifier illegal 
data size 1 Mbytes over 


下 0 

淼別 JT • が 未定義です。 

void 5 ぜ 変数を 宣言して います。 

W 指定 子の 指定が イ 〈正です。 
short 切 指定 子の 指定が イく 正です 0 
unsigned 切 指定 子の 指定が 不正です。 
long 切 指定 子の 指定が イ 〈正 です。 

データ 領 « が 1 メガバイトを 超えて いま 
す。 





function retu 







argument type mismatch 



引数の 型が 異なって います。 
easel : 

int sub (int, short ) ； 

int sub (a, b) 
int a ； 
int b : 

{ 



case2 ： 



int sub (int, short) 



sub (1. 2f, 0. 0 ) ； 



cast conversion 

implied cast conversion 

type mismatch 

pointer type mismatch 

signed type specifier illegal 

assignment const variable, read-only 



identifier length over : 选別子 
label is never usea in function 



明示的な 型変換を 行いました。 

暗黙 的な ® 変換を 行いました。 

三項演 穿 • 子の 型が 輿なります。 
ポインタの 型が あってい ません 0 
signed 型 指定 子の 指定が 不正です。 
const 修飾子の 付いた 変数に 代入して い 
ます。 説み 込み W 用です。 

配 列の 要 索 数が ft の 数な ので 正の 数に し 
ました。 

逄別 子が 技す ぎます。 

一度 も 参照され ていない ラベルが 定義 さ 
れ ています。 




Illegal identifier max length 文字 数 


/E スイッチの 識別子の 文字 数 指定が 不 
正です。 


Illegal warning level レベル 数 


/A スイッチの ワーニング レベル 指定が 
不正です。 







Duplicate case (16 進 値） label (番号) 



& 味 

里^^^^^^^^^^^ ^ 

エネ レー 夕の エラー 



file open error 
Out open error 

Intermediate file error opcode (コー 卜 
番号 > op (オペレーション） 
compiler botch ： call 

illegal operation on structure 

no code table for op : コード 号 

division by zero 

error constand oprand required 

register overflow simplify expression 

unimplemented field operator 

Stack overflow botch 

Intermediate file error 

Expresstion dnput botch 

Binary expression botch 

Illegal initialization 



case 文の 数侦 （16 進 値） が®: 複 してい 
ます。 

作業用 ファイルの オープンに 失敗し まし 
た。 

メモリに 空きが ありません。 

コード ジェネレータの 内部 エラーです 0 
中間 コード 又は 解析の 誤りです。 

コ 一 ド ジェネ レ 一 タの 内部 エラ 一 です 0 
中 問 コード 又は 解析の 淇 りです。 

コード ジェネレータの 内部 エラーです 0 
中 問 コード 又は 解析の 热 りです。 

コード ジェネレータの 内部 エラーです。 
中間 コード 乂は 解析の 淇 りです。 

0 で 除 穿し ました。 

定数 オペランドが 必要な 所に ありませ 
ん 0 

式が 複雑す ぎる ので 作業用 レジスタが あ 
ふれました。 

ビット フィールドに サポートし ていない 

演算を 行いました。 

コード ジェネレータの 内部 エラーです。 
中間 コード 又は 解析の 热 りです。 

コード ジェネレータの 内部 エラーです 0 
中間 コード 又は 解析の 誤りです。 

コード ジェネレータの 内部 エラーです 0 
中間 コード 又は 解析の 誤りです。 

コード ジェネレータの 内部 エラーです 0 
中間 コード 又は 解析の 誤りです。 

初期化 式の 誤りです。 



create 



ン） 

Illegal 



己憶ク 

Compiler error pname called 

op (コード 号）： （才 ペレ ーシ 

Illegal indirection 



Uniplementen structure assigment 



作業用 ファイルが オープンで きません 0 
作業用 ファイルが 作成で きません 0 
コード ジヱネ レー タの 内部 エラーです 0 
中間 コード 又は 解析の 誤りです。 

コード ジェネレータの 内部 エラーです 0 
中 問 コード 又は 解析の 誤りです。 

コード ジェネレータの 内部 エラーです。 
中 問 コード 又は 解析の 淇 りです。 

コード ジェネレータの 内部 エラーです 〇 
中間 コード 又は 解析の 淇 りです。 

コード ジェネレータの 内部 エラーです 〇 
中 問 コード 又は 解析の 热 りです。 

コード ジェネレータの 内部 エラーです 0 
中間 コード 又は 解析の 誤りです。 

コード ジヱネ レー タの 内部 エラーです。 
中間 コード 又は 解析の 誤りです。 
サポートし ていない 構造体 代入を 行い j 



サポートし ていない 構造体の 演 .穿を 行 c 
ました。 



Illegal identifier length 


/E スイッチの 淼別 子の 文字 数 指定が 不 




正です。 | 



イザ 一の エ 



soruce file not found (ファイル 名〉 


作業 川 ファイルが オープンで きません。 


destination file not found (フ アイノ レ 名) 


作業用 ファイルが 作成で きません 0 


sorry , input line too long 


テキスト 入力 用の バッファが あふれ ま 
た。 


Optimizer ： Out of sapce 


メモリが 足りません。 
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沖 勋 小数点 演兑 13 

フロッピー ディスクの 初期化 3 

分割 コンパイル 36 

プリプロセッサ 45、 47 

プロテクト 3 

ヘルプ メッセージ 35 



B 

マニュアル インストール 30 

メイン 関数 90 

戻 0 値 99 



□ 

予約 ファイル 43 



m 

ライブラリ 13 

ライブラリアン 18 



フ アイ ル 19 

ラベル 名 103 

リカ 一 シブ ルコ 一 ル 63 

リス トフ アイ ル 80 



リンカ 

リンク 

ルート デイ レクト 
レジスタの 迟 避 
レジスタ 変数… • 
論理演算 式 …… 



18、 70、 71、 82、 84 
19、 82 



•95 

103 

129 



ワーニング エラー •• 64、 81 
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アルファベット 順 



and 130 

argc 91 

argv 91 

AR. X 9 

AS. X 9、 17 

AUTOEXEC. BAT 30 

AUTO 変数 96 

BASIC 31 、 43、 115 

BASIC2 14 

BASIC. CNF 132 

BASLIB. ARC 15、 19 

BASTOC 15 、 35、 115 

BC 15 、 119、 132 

BIN 9 

CC 11、 32 

CV. X 9 

CLIB. ARC 15、 19 

CONFIG. SYS 7、 30 

DB. X 9 、 31、 36 

DEF 133 

diskcopy 5 

DOSLIB. L 70 

ED 31、 34 

endfunc 130 

equ 95、 97 

ETC 10 

FLOAT1. X 8 

FLOAT2. X 8 

FM •源 ドライバ 8 

format 4 

func 130 

gosub 128、 130 

goto 128 

IEEE 8 



include 18、 132 

IOCS. X 8 

IOCSLIB. L 70 

LIB. X 9 

LK. X 9、 18 

MD— CONT 141 

MDJNIT 141 

MD 一 OFF 142 

MD 一 ON 142 

MD_PLAY 143 

MD KEGK 143 

MD_REGW 144 

MDSTAT 145 

MD STOP 146 

MDWRT 146 

M STAT 147 

MIDI 拡張 MML 148 

MUSIC2. FNC 14 

not 130 

offset 95、 97 

OPMDRV2. X 141 

or 130 

print 131 

rts 96 

SCD. X 9 、 31、 36 

SCSI ドラ イノぐ 8 

switch 47、 131 

TAB 90、 121 

temp 79、 84 

# undef 51 

XC 31 

XC ライブラリ ディスク 15 

xdef 95 

xor 130 
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